TikTok · Guide

How to get TikTok profile region

TL;DR
To get TikTok profile region, sign up for a free Captapi key, then send one GET request to /v1/tiktok/profile-region with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Find out where a TikTok creator is likely based and what language they use — country, language, stable ids, and core profile stats.

How to get TikTok profile region (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the TikTok Profile Region API

    Send an authenticated GET request to /v1/tiktok/profile-region with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/tiktok/profile-region?url=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "tiktok",
    "username": "khaby.lame",
    "displayName": "Khabane lame",
    "url": "https://www.tiktok.com/@khaby.lame",
    "id": "127905465618821121",
    "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
    "createTime": "2016-08-10T22:02:34.000Z",
    "createTimeUnix": 1470866554,
    "ttSeller": false,
    "isOrganization": 0,
    "region": "IT",
    "language": "en",
    "followers": 162355782,
    "following": 81,
    "likes": 2642875898,
    "videos": 1343,
    "verified": true,
    "private": false,
    "profileImage": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=bf39da46&x-expires=1784628000&x-signature=%2BIQ2jcCwEJiHbixnVnOi2G2qh5E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
    "raw": {
      "user": {
        "id": "127905465618821121",
        "shortId": "",
        "uniqueId": "khaby.lame",
        "nickname": "Khabane lame",
        "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=bf39da46&x-expires=1784628000&x-signature=%2BIQ2jcCwEJiHbixnVnOi2G2qh5E%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
        "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=0ed06557&x-expires=1784628000&x-signature=WrS0%2Bg%2FT%2BKycLjzRdl%2Fzdc5i5H0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
        "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=913c08ee&x-expires=1784628000&x-signature=nJ6FpgyLtkWHGaHctQAjTQiqRfE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
        "signature": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎",
        "createTime": 1470866554,
        "verified": true,
        "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
        "ftc": false,
        "relation": 0,
        "openFavorite": false,
        "commentSetting": 0,
        "commerceUserInfo": {
          "commerceUser": false
        },
        "duetSetting": 0,
        "stitchSetting": 0,
        "privateAccount": false,
        "secret": false,
        "isADVirtual": false,
        "roomId": "",
        "uniqueIdModifyTime": 0,
        "ttSeller": false,
        "downloadSetting": 0,
        "profileTab": {
          "showMusicTab": false,
          "showQuestionTab": false,
          "showPlayListTab": false
        },
        "followingVisibility": 1,
        "recommendReason": "",
        "nowInvitationCardUrl": "",
        "nickNameModifyTime": 0,
        "isEmbedBanned": false,
        "canExpPlaylist": true,
        "profileEmbedPermission": 1,
        "language": "en",
        "eventList": [],
        "suggestAccountBind": false,
        "isOrganization": 0,
        "UserStoryStatus": 0,
        "shortDramaCreator": {}
      },
      "statsV2": {
        "followerCount": 162355782,
        "followingCount": 81,
        "heart": 2642875898,
        "heartCount": 2642875898,
        "videoCount": 1343,
        "diggCount": 0,
        "friendCount": 77
      }
    },
    "regionConfidence": "high",
    "regionSource": "inferred"
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesTikTok 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.
rawbooleanNoSet true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only.
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Frequently asked questions

What does the TikTok Profile Region API do?

The TikTok Profile Region API lets you fetch profile or page details and audience stats from a public TikTok profile or page using one GET request to /v1/tiktok/profile-region. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the TikTok Profile Region API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a TikTok API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the TikTok Profile Region API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get TikTok profile region?

Start free with 100 credits — no credit card required.

Get your free API key