Social Fetch
Get API key
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 per successful request.

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