TikTok Creative Center Trends

Get verified public TikTok Creative Center hashtag rankings without a TikTok login, cookies, or an API key. The actor fetches TikTok's public server-rendered Creative Center trend page and returns the anonymous records TikTok actually exposes: rank, hashtags, posts, views, popularity curve, industries, and top creators.

What works today

• Public hashtag rankings by region and 7 or 30 day period
• Rank, posts, views, popularity curve, industry IDs, and visible top creator metadata
• A local industry-ID filter over the public records TikTok returns
• Direct HTTP first, with optional Apify Proxy only when a direct request is blocked
• One trend pay-per-event charge for each verified real trend row saved

Current Creative Center source limits

TikTok changes Creative Center independently of this actor. At the time this version was validated:

• The old creative_radar_api trend JSON routes return 40101 no permission to anonymous callers.
• The public Creative Center hashtag page includes stable server-rendered data and is the only source used for chargeable output.
• The Video page displays a small browser preview but does not include stable anonymous video records in the direct public page response used by the actor.
• Creator is marked Coming soon, Song or Music is absent from the current public Trends page, and the current Top Ads route resolves to 404 for anonymous traffic.

Selecting video, creator, song, or ad creates an explicit PUBLIC_SOURCE_UNAVAILABLE diagnostic. Diagnostics are never charged. This avoids presenting login-gated or absent data as a working product.

Input

Field	Default	Description
trendTypes	["hashtag"]	Trend types to attempt. Only hashtag currently produces chargeable public records.
region	US	Country code supported by anonymous hashtag rankings.
periodDays	7	7 or 30 day Creative Center comparison period.
industryIds	empty	Optional exact industry-ID filter applied to returned public hashtag results.
maxResults	3	Up to three anonymous rankings currently exposed by Creative Center.
requestTimeoutSecs	25	HTTP request timeout, from 8 to 60 seconds.
proxyConfiguration	off	Optional Apify Proxy configuration.

Example:

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

Output

Each verified public ranking produces one row:

{
  "ok": true,
  "trendType": "hashtag",
  "rank": 1,
  "region": "US",
  "periodDays": 7,
  "hashtag": "#exampletrend",
  "posts": 17111,
  "views": 28789647,
  "industryIds": ["23000000000"],
  "popularityCurve": [
    { "timestamp": "2026-07-19T00:00:00.000Z", "value": 54.2 }
  ],
  "topCreators": [
    { "rank": 1, "handle": "examplecreator", "followers": 120000, "country": "US" }
  ],
  "source": "tiktok_creative_center_public_ssr",
  "sourceUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag?region=US&period=7"
}

Empty input returns a labeled sample row for automated Apify checks and Store previews. Bad input, a source block, no matching industry, unavailable types, and parsing failures return ok: false diagnostic rows. No sample or diagnostic row is charged.

Proxy and cost guidance

Start with direct HTTP. The validated US anonymous page returned HTTP 200 without a proxy. Enable a proxy only after a 403 or 429 response, because a residential proxy adds bandwidth cost to an otherwise small HTML response.

Residential proxy traffic does not make unavailable trend types profitable: it cannot turn the permission-denied legacy API, Coming soon Creator tab, absent Song tab, or missing Top Ads route into a verified anonymous source. Before setting a Store event price, run direct and residential benchmark batches with the exact response sizes and require the post-platform-fee margin to stay positive.

Run locally

npm ci
npm test
npm run check
npm run test:live

npm run test:live calls the public US hashtag page and fails unless it receives at least one real normalized row. It makes no Apify event charges.