Social Fetch
TikTok

List TikTok profile following

Get accounts followed by a specific TikTok profile.

Operation

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

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

handlestringrequired

TikTok handle whose following list should be listed.

min 1 chars · max 64 chars

cursorstring(query)

Pagination cursor returned by a previous response.

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 following could be listed for this handle.

one of: found, hidden, private, not_found

dataaccounts
arrayrequired

Accounts followed by the requested TikTok profile on this page when `lookupStatus` is `found`. Empty when `lookupStatus` is `hidden`, `private`, or `not_found`, or when the resolved profile follows nobody on this page.

dataaccounts[]handle
stringrequired

TikTok username without the leading @.

min 1 chars

dataaccounts[]displayName
stringrequirednullable

Public display name shown on the TikTok profile.

dataaccounts[]bio
stringrequirednullable

Profile biography text.

dataaccounts[]avatarUrl
stringrequirednullable

Best available avatar image URL for the account.

dataaccounts[]profileUrl
stringrequired

Canonical public TikTok profile URL.

min 1 chars

dataaccounts[]platformUserId
string

TikTok numeric user id as a string, when available.

dataaccounts[]secUid
string

TikTok opaque stable user identifier, when available.

dataaccounts[]verified
booleanrequired

Whether TikTok marks the account as verified.

dataaccounts[]privateAccount
boolean

Whether TikTok marks the account as private.

dataaccounts[]region
string

Region code reported by TikTok, when available.

dataaccounts[]language
string

Language code reported by TikTok, when available.

dataaccounts[]accountCreatedAt
integer

Account creation time as Unix epoch seconds from TikTok, when provided.

≥ 0

dataaccounts[]metrics
objectrequired

Aggregate metrics for the account.

dataaccounts[]metricsfollowers
integerrequired

Follower count reported by TikTok for the account.

≥ 0

dataaccounts[]metricsfollowing
integerrequired

Following count reported by TikTok for the account.

≥ 0

dataaccounts[]metricsposts
integerrequired

Public post or video count reported by TikTok for the account.

≥ 0

dataaccounts[]details
object

Additional TikTok-native fields for this account that were not mapped into canonical fields.

datapage
objectrequired

Pagination state for the current response.

datapagenextCursor
stringrequirednullable

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

datapagehasMore
booleanrequired

Whether another page of accounts is available.

datatotalAccounts
integerrequirednullable

Total following count reported by TikTok 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

Accounts followed by the requested TikTok profile.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page