Social Fetch
TikTok

Get TikTok profile region

Get the region code reported for a TikTok profile.

Operation

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

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

handlestringrequired

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

min 1 chars · max 64 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether a TikTok profile could be resolved for the handle.

one of: found, not_found

dataprofile
objectrequirednullable

Profile identity when the lookup resolved.

dataprofileplatform
stringrequired

Social platform for this profile.

one of: tiktok

dataprofilehandle
stringrequired

TikTok username without the leading @.

dataprofileprofileUrl
stringrequired

Canonical public TikTok profile URL.

min 1 chars

dataregion
stringrequirednullable

Country or region code reported for the profile when available. Null when the profile could not be resolved.

min 1 chars

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

Lookup result. Check `data.lookupStatus` for `found` or `not_found`; when found, `data.profile` contains profile identity and `data.region` contains the reported region code.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page