TikTok Creative Center Hashtag Trends

Extract ranked public hashtag trends from TikTok Creative Center's anonymous public trend endpoint. The Actor returns normalized hashtag IDs, ranks, post counts, video views, industry IDs, popularity curves, public top-creator summaries, durable TikTok hashtag URLs, and source timestamps.

It does not require account cookies or an API key, and it does not access private profiles, private recommendations, or user activity.

Example input

{
  "countryCode": "US",
  "periodDays": 7,
  "maxItems": 50,
  "maxPages": 5,
  "pageSize": 20,
  "requestDelayMs": 300
}

Omitted fields use the same defaults shown in the Input tab: US, 7 days, 50 results, 5 pages, 20 items per request, and a 300 ms delay.

Example output

{
  "recordType": "tiktok-hashtag-trend",
  "status": "success",
  "dataAvailable": true,
  "source": "TikTok Creative Center",
  "provenance": "anonymous_public_creative_center",
  "sourceTransport": "https_post",
  "extractionMethod": "creative_center_hashtag_api",
  "hashtagId": "12345",
  "hashtag": "#dance",
  "rank": 1,
  "countryCode": "US",
  "periodDays": 7,
  "postCount": 125000,
  "videoViews": 420000000,
  "industryIds": ["1"],
  "popularityCurve": [
    { "timestamp": "2026-08-18T00:00:00.000Z", "popularity": 92 }
  ],
  "topCreators": [
    { "creatorId": "creator-1", "username": "creator", "profileUrl": "https://www.tiktok.com/@creator" }
  ],
  "hashtagUrl": "https://www.tiktok.com/tag/dance",
  "sourceUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag?region=US&period=7",
  "scrapedAt": "2026-08-18T00:00:00.000Z"
}

If the public endpoint fails or returns no usable rows, the dataset receives a tiktok-hashtag-trends-error diagnostic and the OUTPUT key-value record reports status: "failed" with the error.

Input

• countryCode: Supported Creative Center market code. Default: US.
• periodDays: Trend window; supported values are 7, 30, or 120. Default: 7.
• maxItems (1–1000): Global deduplicated hashtag limit. Default: 50.
• maxPages (1–50): Pagination safety bound. Default: 5.
• pageSize (1–50): Items requested per public API page. Default: 20.
• requestDelayMs (100–5000): Sequential delay between pages. Default: 300.

Output and storage

Normalized trend rows and error diagnostics are written to the default dataset. The Output tab links to the dataset and to OUTPUT in the default key-value store.

OUTPUT contains the selected market and period, requested pagination settings, item count, unique hashtag count, status, and error details when applicable.

Reliability, limitations, and cost

Requests are sequential, use browser-compatible headers, have a bounded timeout, and retry transient failures up to three times with backoff. Results change continuously by market and period. Avatar URLs may expire because TikTok signs its CDN URLs, while normalized hashtag and profile URLs are durable references.

Apify compute and public HTTP traffic are the main costs. Keep page and item limits reasonable and use a responsible delay between pages.

FAQ and disclaimer

Does this Actor use a private TikTok account?

No. It uses the anonymous public Creative Center trend endpoint.

Why did a trend field disappear?

The source did not expose a usable value or the value failed safe numeric/date normalization. Optional fields are omitted rather than replaced with placeholders.

Are rankings permanent?

No. Rankings and counts vary by country, selected period, and the time of the request.

Use results only for a legitimate purpose, follow TikTok terms and robots guidance, and review privacy and data-protection obligations before processing public creator information. For support, use the Actor Issues tab.