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

Geo routing, shop market checks, and creator CRM enrichment often need the region TikTok associates with an account, not the full profile card and not an audience-country breakdown. You already have a handle; you want a short code you can store next to the creator row and reuse when other TikTok routes take a `region` hint.

`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}`. Pricing is on the credit badge for this operation; bill from `meta.creditsCharged`. on every response.

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