Get TikTok profile region

Get the region code reported for a TikTok profile by handle.

GET/v1/tiktok/profiles/{handle}/region
1credit
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
13

Endpoint-specific response payload.

datalookupStatus
string

Whether a TikTok profile 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

dataregion
stringnullable

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

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/tiktok/profiles/charlidamelio/region" \
  -H "x-api-key: YOUR_API_KEY"

Responses

TikTok profile region.