TikTok Audience Demographics API

What is the TikTok Audience Demographics API?

Give a profile URL, @handle, or username and get a ranked audience-country breakdown as clean JSON. TikTok does not publish follower geography — we sample people engaging with recent videos. The two signals come from two populations, disclosed in the response: audienceLanguages[] are tallied from top-level commenters (basis.language="commenters"), while audienceLocations[] come from repliers under the most-replied parent comments (basis.region="repliers") — the only public surface that reliably exposes user.region. Each country row carries country name, countryCode, count, and numeric percentage (+ percentageText). Response includes sampleSize, totalCountries, regionSampleParents + regionSampleVideos (how many distinct parent threads / videos the region sample is spread over), and a clustering-aware confidence: the size-based label (low <400, medium 400–999, high ≥1000) is CAPPED when the region sample is concentrated in few threads (<8 parents or <4 videos → low; <20 parents or <8 videos → at most medium), because 400 repliers from 6 threads are not 400 independent observations. Optional other{} only when countriesLimit truncates. timings{path,postsVia,postsMs,postsDeadlineMs,commentsMs,commentsVia,totalMs,videoConcurrency,commentsAttempts,commentsErrors,commentsAttemptsPerVideo} — postsVia names the leg that served the video list (native|apify), commentsVia the comments surface (web+replies), commentsErrors counts blocked comment requests absorbed before clean pages, and commentsAttemptsPerVideo is the per-video attempts distribution (sorted desc). If the posts leg hits its deadline on a real profile you get a degraded 200 (degraded:true, degradedReason:"posts-timeout", 0 credits) — 404 NOT_FOUND is reserved for profiles positively confirmed absent, never for a slow fetch. Choose videos=12|30|60 (credits 3/5/8) for sample depth. Percentages across audienceLocations (+ other) sum to ~100%. This reflects who engages, not a full follower census.

What you get

• Numeric percentage + percentageText per country
• totalCountries + other{} only when truncated
• basis{language:commenters, region:repliers} — the two sampled populations, disclosed
• regionSampleParents + regionSampleVideos with clustering-aware confidence
• audienceLanguages[] from top-level commenters
• videos=12|30|60 with scaled credits (3/5/8)
• Degraded posts-timeout 200 at 0 credits — 404 only for confirmed-absent profiles

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

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

Example response

{
  "success": true,
  "data": {
    "platform": "tiktok",
    "username": "khaby.lame",
    "url": "https://www.tiktok.com/@khaby.lame",
    "videosSampled": 12,
    "sampleSize": 269,
    "audienceLocations": [
      {
        "country": "Pakistan",
        "countryCode": "PK",
        "count": 70,
        "percentage": 26.02,
        "percentageText": "26.02%"
      },
      {
        "country": "United States",
        "countryCode": "US",
        "count": 33,
        "percentage": 12.27,
        "percentageText": "12.27%"
      }
    ],
    "basis": {
      "language": "commenters",
      "region": "repliers"
    },
    "videosRequested": 12,
    "totalCountries": 23,
    "confidence": "low",
    "other": {
      "count": 129,
      "percentage": 47.96,
      "percentageText": "47.96%"
    },
    "audienceLanguages": [
      {
        "language": "en",
        "count": 142,
        "percentage": 52.79,
        "percentageText": "52.79%"
      },
      {
        "language": "ur",
        "count": 61,
        "percentage": 22.68,
        "percentageText": "22.68%"
      }
    ],
    "languageSampleSize": 269,
    "regionSampleParents": 41,
    "regionSampleVideos": 11
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 3 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/tiktok/audience-demographics and parse the JSON response.

Use cases

Frequently asked questions

More TikTok APIs