TikTok Trending Hashtags — Creative Center rankings

Reads TikTok's own Creative Center hashtag ranking for a country and a time window. You get the rank, how many posts and views the tag has, the industries TikTok files it under, the day-by-day popularity curve behind the ranking, and the creators currently driving it.

This is TikTok's published trend data, not a guess assembled from scraped videos. No login, no cookie, no API key.

Read this first: it returns up to three hashtags per run

TikTok's anonymous Creative Center page exposes three ranked hashtags. Not thirty, not a hundred — three. Everything past that sits behind a Creative Center login, and asking for a higher maxResults doesn't reach it.

Three is genuinely useful: it's the top of the ranking for a country over a window, and you can run it across 27 countries or on a schedule to build a series. But if you came here expecting a full leaderboard export, this isn't that, and it's better you know now than after a run.

What you get

A real row, trimmed for length:

{
  "ok": true,
  "trendType": "hashtag",
  "rank": 1,
  "region": "US",
  "periodDays": 7,
  "hashtag": "#unicornfrappuccino",
  "hashtagId": "63554219",
  "posts": 56830,
  "views": 215410174,
  "industryIds": ["27000000000"],
  "popularityCurve": [
    { "timestamp": "2026-08-13T00:00:00.000Z", "value": 0 },
    { "timestamp": "2026-08-14T00:00:00.000Z", "value": 19.85 },
    { "timestamp": "2026-08-15T00:00:00.000Z", "value": 100 },
    { "timestamp": "2026-08-16T00:00:00.000Z", "value": 94.71 }
  ],
  "topCreators": [
    { "rank": 1, "handle": "sofia1089", "name": "sof", "followers": 33241, "country": "US", "profileImageUrl": "https://…" }
  ],
  "source": "tiktok_creative_center_public_ssr",
  "sourceUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag?region=US&period=7",
  "fetchedAt": "2026-08-21T…",
  "proxyUsed": false
}

popularityCurve values are TikTok's normalised index, 0–100 across the window, not absolute post counts — the peak day is always 100. posts and views are the real totals.

Input

{
  "trendTypes": ["hashtag"],
  "region": "US",
  "periodDays": 7,
  "maxResults": 3
}

Field	Default	Notes
trendTypes	["hashtag"]	See the section below about the other types.
region	US	One of: US, FR, DE, IT, ES, GB, AR, AU, BR, CA, CO, EG, ID, IL, JP, KR, MY, MX, PH, SA, SG, ZA, TW, TH, TR, AE, VN.
periodDays	7	Only 7 or 30 are real values. Anything else is treated as 7.
industryIds	—	Optional filter applied to what came back. Use the ids TikTok itself exposes, e.g. 11000000000. It narrows the three results; it doesn't fetch more.
maxResults	3	1 to 3. Higher values are clamped, because the public page has no fourth row to give.
requestTimeoutSecs	25	Ceiling on the Creative Center page request.
sessionCookies	—	Optional. Only used if the anonymous page comes back blocked. Stored as a secret.
proxyConfiguration	off	Direct requests by default, which is what works. A residential proxy costs you bandwidth and gets you past nothing that is login-gated.

Run it with no input and you get one labelled sample row, charged nothing.

Video, creator, song and ad trends

You can ask for them. You won't get them, and you won't be billed for asking.

Those four rankings aren't on the anonymous Creative Center page — they need a Creative Center login. Request one and the actor returns a PUBLIC_SOURCE_UNAVAILABLE diagnostic row that says so plainly, free of charge. It doesn't fabricate a row, and it doesn't quietly return hashtags and hope you don't notice.

Limits

• Three hashtags per region per run. See above.
• Rankings update on TikTok's schedule, not on request. Running the same region twice in an hour will usually return the same three tags.
• popularityCurve has one point per day in the window: 7 points on a 7-day run, 30 on a 30-day one.
• topCreators is TikTok's own list for that tag, typically a handful of accounts, not everyone posting under it.
• If the Creative Center page is blocked or returns nothing, you get a diagnostic row explaining which, not an empty dataset.

Billing

$0.008 per trend row returned. There is no run-start fee on this actor — a run that returns nothing costs nothing at all.

So a full three-hashtag run is $0.024. Sample rows, diagnostic rows, unavailable trend types and blocked pages are never charged.