List TikTok profile followers

List followers of a TikTok profile by handle.

GET/v1/tiktok/profiles/{handle}/followers
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
handlestringrequiredpath

TikTok handle whose followers should be listed.

min 1 chars · max 128 chars

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

userIdstringoptionalquery

Optional TikTok user id to speed up the request.

min 1 chars

trimbooleanoptionalquery

Optional flag for a smaller response with fewer fields.

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether followers could be listed for this handle.

one of: found, hidden, private, not_found

Followers for the requested profile page.

datafollowers[]handle
string

Public TikTok username without a leading @.

min 1 chars

datafollowers[]displayName
stringnullable

Display name shown on the follower profile.

datafollowers[]avatarUrl
stringnullable

Best available profile image URL when available.

Avatar URLs at multiple resolutions when available.

datafollowers[]avatarUrlslarge
stringoptional

Large avatar URL when available.

datafollowers[]avatarUrlsmedium
stringoptional

Medium avatar URL when available.

datafollowers[]avatarUrlsthumb
stringoptional

Thumbnail avatar URL when available.

datafollowers[]platformUserId
stringoptional

Numeric user id for the follower when available.

datafollowers[]secUid
stringoptional

Opaque stable user identifier when available.

datafollowers[]bio
stringnullable

Profile biography text when available.

datafollowers[]verified
boolean

Whether TikTok marks the follower as verified.

datafollowers[]privateAccount
boolean

Whether the follower account is private.

Follower and following counts for this account.

datafollowers[]metricsfollowers
integer

Follower count reported for this account.

≥ 0

datafollowers[]metricsfollowing
integer

Following count reported for this account.

≥ 0

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more followers are available.

datapagehasMore
boolean

Whether another page of followers is available.

datatotalFollowers
integernullable

Total follower count for the requested profile when available.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/tiktok/profiles/charlidamelio/followers" \
  -H "x-api-key: YOUR_API_KEY"

Responses

TikTok followers for the requested profile.