TikTok

Get TikTok profile audience

Get audience location demographics for a TikTok profile by handle.

GET/v1/tiktok/profiles/{handle}/audience
30credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

TikTok handle to look up, with or without a leading @.

min 1 chars · max 128 chars

Response fields
16

Endpoint-specific response payload.

datalookupStatus
string

Whether audience demographics could be resolved for the handle.

one of: found, not_found

Profile identity when the lookup resolved.

dataprofileplatform
string

Social platform for this profile.

one of: tiktok

dataprofilehandle
string

TikTok username without the leading @.

dataprofileprofileUrl
string

Canonical public TikTok profile URL.

min 1 chars

Country-level audience breakdown when available. Null when the profile could not be resolved.

dataaudienceLocations[]country
string

Country name for this audience segment.

min 1 chars

dataaudienceLocations[]countryCode
string

ISO country code for this audience segment.

min 1 chars

dataaudienceLocations[]count
integer

Audience count reported for this country.

≥ 0

dataaudienceLocations[]percentage
string

Share of the audience for this country, as a percentage string (for example "15.96%").

min 1 chars

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/audience" \
  -H "x-api-key: YOUR_API_KEY"

Responses

TikTok profile audience demographics.