POST
/
v1
/
tiktok
/
followers
curl -X POST https://api.zocialmine.com/v1/tiktok/followers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username",
    "minCursor": "0"
  }'

{
  "status": "success",
  "data": {
    "followers": [
      {
        "id": "6943345678901234567",
        "uniqueId": "follower_user",
        "nickname": "Follower Name",
        "avatarThumb": "https://p16-sign.tiktokcdn.com/...",
        "verified": false
      }
    ],
    "hasMore": true,
    "minCursor": "1700000000000",
    "total": 1500000
  }
}
Fetches the followers list for a TikTok user. Returns 30 followers per page with cursor-based pagination. Cost: 1 credit per request.

​
Request

​
url
string
required
The TikTok profile URL.Example: https://www.tiktok.com/@username
​
secUid
string
The user’s secUid. Auto-extracted from the profile URL if not provided.
​
minCursor
string
default:"0"
Pagination cursor. Use "0" for the first page, then pass the returned minCursor for subsequent pages.
​
webhook
string
A URL to receive the response via webhook. If provided, the request will be processed asynchronously and the result will be sent to this URL.

​
Response

​
status
string
"success" on successful request.
​
data
object
curl -X POST https://api.zocialmine.com/v1/tiktok/followers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username",
    "minCursor": "0"
  }'

{
  "status": "success",
  "data": {
    "followers": [
      {
        "id": "6943345678901234567",
        "uniqueId": "follower_user",
        "nickname": "Follower Name",
        "avatarThumb": "https://p16-sign.tiktokcdn.com/...",
        "verified": false
      }
    ],
    "hasMore": true,
    "minCursor": "1700000000000",
    "total": 1500000
  }
}