Skip to content
tiktokapi.io
All endpoints

Get user followers list

GET/v1/user/followers1 Credit / user (min 10 Credits)($0.10 / 1K followers)

Paginated list of accounts following a creator (data.followers), up to 200 per request. First retrieve user_id and sec_uid from /v1/user/info, then pass data.min_time as time for subsequent pages.

Query Parameters

  • user_idstringrequired

    Numeric TikTok user ID (data.user.id from /v1/user/info).

    Example: 107955

  • sec_uidstring

    SecUID (data.user.secUid from /v1/user/info). Recommended for reliability.

    Example: MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM

  • countinteger (1 to 200)

    Number of followers per request (max 200).

    Example: 50

  • timeinteger

    Pagination timestamp cursor (0 for first page, then pass data.min_time).

    Example: 0

Example Request (cURL / Python / JavaScript)

curl "https://api.tiktokapi.io/v1/user/followers?user_id=107955" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.15,
  "data": {}
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

FieldTypeSample / Notes
codeintegerExample: 0
msgstringExample: success
processed_timenumberExample: 0.15
dataobject

Status Codes

200
Success (code === 0). Charged according to the endpoint credit rate.
400
Invalid parameters, or API key placed in the URL query string (not charged).
401
Missing or invalid x-api-key header (not charged).
402
Insufficient credit balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint or disabled unstable endpoint (not charged).
405
Method not allowed — all /v1/* data endpoints use GET (not charged).
429
Rate limit exceeded (not charged). Respect the Retry-After header.
503
Temporary upstream or gateway error (not charged). Retry with exponential backoff.