Social Fetch
TikTok

List TikTok profile followers

Get followers from a specific TikTok profile.

Operation

GET/v1/tiktok/profiles/{handle}/followers

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

handlestringrequired

TikTok handle whose followers should be listed.

min 1 chars · max 64 chars

cursorstring(query)

Pagination cursor returned by a previous response.

min 1 chars

userIdstring(query)

Optional TikTok user id to speed up the request.

min 1 chars

trimboolean(query)

Optional flag for a smaller response with fewer fields.

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether followers could be listed for this handle.

one of: found, hidden, private, not_found

datafollowers
arrayrequired

Followers for the requested profile page when `lookupStatus` is `found`. Empty when `lookupStatus` is `hidden`, `private`, or `not_found`, or when the resolved profile has no followers in this page.

datafollowers[]handle
stringrequired

Public TikTok username without a leading @.

min 1 chars

datafollowers[]displayName
stringrequirednullable

Display name shown on the follower profile.

datafollowers[]avatarUrl
stringrequirednullable

Best available profile image URL when available.

datafollowers[]avatarUrls
object

Avatar URLs at multiple resolutions when available.

datafollowers[]avatarUrlslarge
string

Large avatar URL when available.

datafollowers[]avatarUrlsmedium
string

Medium avatar URL when available.

datafollowers[]avatarUrlsthumb
string

Thumbnail avatar URL when available.

datafollowers[]platformUserId
string

Numeric user id for the follower when available.

datafollowers[]secUid
string

Opaque stable user identifier when available.

datafollowers[]bio
stringrequirednullable

Profile biography text when available.

datafollowers[]verified
booleanrequired

Whether TikTok marks the follower as verified.

datafollowers[]privateAccount
booleanrequired

Whether the follower account is private.

datafollowers[]metrics
objectrequired

Follower and following counts for this account.

datafollowers[]metricsfollowers
integerrequired

Follower count reported for this account.

≥ 0

datafollowers[]metricsfollowing
integerrequired

Following count reported for this account.

≥ 0

datapage
objectrequired

Pagination state for the current response.

datapagenextCursor
stringrequirednullable

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

datapagehasMore
booleanrequired

Whether another page of followers is available.

datatotalFollowers
integerrequirednullable

Total follower count for the requested profile when `lookupStatus` is `found` and a count is available; otherwise null.

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

TikTok followers for the requested profile.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page