Social Fetch
Start for freeStart free
TikTok hub

TikTok profile region API

Resolve the region code TikTok reports for a public handle as structured JSON in the shared Social Fetch envelope.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/tiktok/profiles/{handle}/region takes a TikTok handle (with or without a leading @) and returns data.region when the lookup resolves: a country or region code string such as US, GB, or MX. Compact identity sits under data.profile (platform, handle, profileUrl). Branch on data.lookupStatus before you write: found and not_found are explicit. On not_found, profile and region are null.

This is the account's reported region, not country-level audience mix. Audience demographics are GET /v1/tiktok/profiles/{handle}/audience. Bio, avatar, and follower totals are GET /v1/tiktok/profiles/{handle}. Bill from meta.creditsCharged.

TikTok profile region API FAQ

How do I get a TikTok profile region code by handle via API?

Call GET /v1/tiktok/profiles/{handle}/region with your Social Fetch API key (x-api-key). Pass the TikTok username as the path parameter, with or without a leading @. Read data.lookupStatus, then data.region and data.profile when the status is found.

How much does the TikTok profile region API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What does the TikTok profile region API return?

On found, data.region is the country or region code reported for the profile (for example US or MX), plus data.profile with platform, handle, and profileUrl. The envelope also includes data.lookupStatus, meta.requestId, and meta.creditsCharged.

What does lookupStatus mean on the TikTok region route?

found means a profile could be resolved and region may be present. not_found means no profile matched; profile and region are null. Always branch on lookupStatus before treating a null region as "unknown market."

How is profile region different from profile audience?

Region is the single region code reported for the account. Audience (GET /v1/tiktok/profiles/{handle}/audience) returns country-level audience mix rows (country, countryCode, count, percentage). Use region when you need the account's reported market; use audience when you need where followers sit.

Do I need TikTok OAuth to fetch a profile region?

No. You authenticate to Social Fetch with an API key. The route returns the region code when available for the handle; it does not act on behalf of a logged-in TikTok user.

Can I use this before calling TikTok Shop or trending routes?

Yes. Teams resolve data.region once, store it on the creator record, then pass that code into routes that accept a region parameter (for example showcase products or trending feed). Keep meta.requestId if you need support on a failed lookup.

Other TikTok endpoints