TikTok

TikTok Profile Region API

Find out where a TikTok creator is likely based and what language they use — country, language, stable ids, and core profile stats.

Give the TikTok Profile Region API a profile URL, @handle, or username and it returns creator geography and language as clean JSON — the dedicated geo surface. channel-details (1 credit) reads the same profile page and emits region only when TikTok itself publishes it (rare) — it never guesses. This endpoint adds the work that justifies 2 credits: when the page has no country we run an AI estimate from bio / display name / username / language (regionSource=inferred + regionConfidence; a username that merely equals a country name — @syria, @france — is not treated as evidence). When TikTok blocks the profile fetch the call is 503 at 0 credits; a handle TikTok does not have is 404. The response tells you whether the country came from TikTok or from that estimate. You also get stable id + secUid, account createTime / createTimeUnix, ttSeller + isOrganization (boolean), interface language, and core profile stats — followers, following, total likes, and videos (integer count) — plus display name, verified and private flags, and the avatar. Stats on this surface may be TTL-stale; use channel-details when you need a fresh identity card. Upstream TikTok blobs are not returned by default — pass raw=true only when you need the opt-in escape hatch. Flat 2 credits per live call. Pass cache=true for the 7d shared cache (0 credits on hit), or cacheMaxAge=1d|3d|7d|14d|30d; default is always fresh.

Docs: https://captapi.com/apis/tiktok-profile-region

get/v1/tiktok/profile-region

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/tiktok/profile-region
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring required

TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.

rawboolean

Set true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only.

cacheboolean

Set true to serve from the 7d response cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.

cacheMaxAge'1d' | '3d' | '7d' | '14d' | '30d'

Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.