Social Fetch
TikTok

List TikTok profile followers

Get followers from a specific TikTok profile.

Use `lookupStatus` to distinguish found, hidden, private, and not_found. Call `GET /v1/tiktok/profiles/{handle}` when you need full profile details.

An empty `data.followers` array with `lookupStatus: "found"` means the profile resolved but this page returned no followers (for example a zero-follower account).

GET/v1/tiktok/profiles/{handle}/followers
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
4
handle*stringpath

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
26

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

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.

On this page

No Headings