TikTok Popular Hashtags API

What is the TikTok Popular Hashtags API?

Reads TikTok Creative Center's popular-hashtag chart when query is omitted or query=trending (10s cap; typically a few seconds). Signed-out Creative Center access lists the top 3 hashtags per country and period — pagination.totalCount says how many exist, and a note explains it when you asked for more. Each chart row has the period's post count (videoCount), views (totalPlays), trend[] and topCreators. period=120 and newOnBoard=true are not served by the chart (chartStatus=fetch_empty / filter_unsupported) and use the fallback. A chart miss falls through to related-tag co-occurrence seeded with fyp — source is niche_fallback, not a silent substitute — and opens a circuit for the same country/period/page/industry (chartStatus=skipped_circuit_open) until the 60s cooldown (300s after 3 misses) expires. Pass query=<niche> (e.g. skincare) to skip the chart and get up to limit related tags. A query that is not a TikTok hashtag (a typo or made-up word) is 404 HASHTAG_NOT_FOUND at 0 credits instead of unrelated tags. A double miss is 502 with a 60s negative cache for the same parameters (persistent after 3); other parameters are unaffected. Overall 80s deadline. Flat 2 credits on a 200; 5xx stay 0.

What you get

• source=creative_center | niche_fallback — which path produced the list
• Chart rows: rank, videoCount, totalPlays, trend[], topCreators
• chartStatus skipped_circuit_open vs timeout/fetch_empty/filter_unsupported — skip ≠ miss
• query=<niche> skips the chart for a longer related-tag list

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/popular-hashtags" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "query": "skincare",
    "discovery": "co_occurrence",
    "discoverySource": "hashtag_page",
    "sampleSize": 20,
    "rankBy": "videoCount",
    "fetchedAt": "2026-08-03T15:08:07.000Z",
    "totalReturned": 2,
    "hashtags": [
      {
        "name": "skincare",
        "url": "https://www.tiktok.com/tag/skincare",
        "rank": 1,
        "hashtagId": "504245",
        "videoCount": 56953998,
        "totalPlays": 954780316160,
        "sampleVideoCount": 17,
        "samplePlays": 40305805,
        "growthRate": null
      },
      {
        "name": "skincareroutine",
        "url": "https://www.tiktok.com/tag/skincareroutine",
        "rank": 2,
        "hashtagId": "42164",
        "videoCount": 8200000,
        "totalPlays": 120000000000,
        "sampleVideoCount": 5,
        "samplePlays": 3003805,
        "growthRate": null
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Request-Id (include it when contacting support). Where the response has a source field, it names the path that served the data: native, extended, cache or asr. 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 and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 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/popular-hashtags and parse the JSON response.

Use cases

Frequently asked questions

More TikTok APIs