Social Fetch
TikTok

List TikTok profile following

Get accounts followed by 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.accounts` array with `lookupStatus: "found"` means the profile resolved but this page returned no accounts (for example the profile follows nobody).

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

API key (`sfk_...`)

Parameters
3
handle*stringpath

TikTok handle whose following list should be listed.

min 1 chars · max 128 chars

cursorstringoptionalquery

Pagination cursor returned by a previous response.

min 1 chars

trimbooleanoptionalquery

Optional flag for a smaller response with fewer fields.

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

Whether following could be listed for this handle.

one of: found, hidden, private, not_found

Accounts followed by the requested TikTok profile on this page.

dataaccounts[]handle
string

TikTok username without the leading @.

min 1 chars

dataaccounts[]displayName
stringnullable

Public display name shown on the TikTok profile.

dataaccounts[]bio
stringnullable

Profile biography text.

dataaccounts[]avatarUrl
stringnullable

Best available avatar image URL for the account.

dataaccounts[]profileUrl
string

Canonical public TikTok profile URL.

min 1 chars

dataaccounts[]platformUserId
stringoptional

TikTok numeric user id as a string, when available.

dataaccounts[]secUid
stringoptional

TikTok opaque stable user identifier, when available.

dataaccounts[]verified
boolean

Whether TikTok marks the account as verified.

dataaccounts[]privateAccount
booleanoptional

Whether TikTok marks the account as private.

dataaccounts[]region
stringoptional

Region code reported by TikTok, when available.

dataaccounts[]language
stringoptional

Language code reported by TikTok, when available.

dataaccounts[]accountCreatedAt
integeroptional

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

≥ 0

Aggregate metrics for the account.

dataaccounts[]metricsfollowers
integer

Follower count reported by TikTok for the account.

≥ 0

dataaccounts[]metricsfollowing
integer

Following count reported by TikTok for the account.

≥ 0

dataaccounts[]metricsposts
integer

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

≥ 0

dataaccounts[]details
objectoptional

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

Pagination state for the current response.

datapagenextCursor
stringnullable

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

datapagehasMore
boolean

Whether another page of accounts is available.

datatotalAccounts
integernullable

Total following count reported by TikTok 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/following" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Accounts followed by the requested TikTok profile.

On this page

No Headings