tiktok-creative-center/
trending-hashtags

The TikTok Creative Center Trending Hashtags API returns the ranked list of hashtags trending in a country on Creative Center, with post and view counts and a daily popularity curve over 7, 30 or 90 days.

TikTok Creative Center Trending Hashtags API

Country rankings
7, 30 or 90 days
Daily popularity curve
0.5 credits / result
Ready
README

By SocQ · Updated

TikTok Creative Center Trending Hashtags

Creative Center's trending hashtags rank the tags gaining the most attention in a country over the last 7, 30 or 90 days, giving each one its position, post count, views and a day-by-day popularity curve. The ranking shows which topics are taking off in a market, how sharply each tag rose and which trends are worth joining while they are still climbing.

TikTok Creative Center Trending Hashtags API Features

  • One ranking per countrycountry takes a two-letter code such as US, GB or JP, and every market returns its own rank order.
  • 7-, 30- and 90-day liststime_range chooses the window the ranking is built over, and each window is its own list.
  • Post and view countsmetrics.posts_count and metrics.views_count give the volume Creative Center reports for each tag.
  • Daily popularity curvepopularity_curve returns one dated value per day on a 0 to 100 scale, so a tag's trajectory arrives with its ranking row.
  • Tag name, link and IDEach row carries name without the #, a tiktok.com/tag url and the id that Hashtag Insights takes as hashtag_id.

TikTok Creative Center Trending Hashtags API Parameters

ParametersRequiredDescription
countryOptionalTwo-letter country code of the market, such as US, GB or JP. Defaults to US.
time_rangeOptionalPeriod the ranking covers: 7d (default), 30d or 90d.
results_limitOptionalHow many hashtags to return, from 1 to 100. Defaults to 20.

How to Use the TikTok Creative Center Trending Hashtags API

Pick a country and window, then read the ranking from the TikTok Creative Center Trending Hashtags API.

  1. POST {"country": "US", "time_range": "7d", "results_limit": 20} to /v1/tiktok-creative-center/trending-hashtags.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read hashtags from results.items in rank order and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","time_range":"7d","results_limit":20}'

# Each item has rank, metrics and a dated popularity_curve.

TikTok Creative Center Trending Hashtags API Use Cases

  • Daily new-entrant tracking: Store each day's TikTok Creative Center Trending Hashtags API list with its collected_at and compare ids against the previous snapshot to see which hashtags entered or left a country's ranking.
  • Per-market hashtag shortlists: Request the same time_range for each target country and set the lists side by side to choose tags for each localized campaign.
  • Spike versus staying power: Compare the 7d and 90d lists of one country: tags that appear only in the short list are one-week spikes, tags that rank high in both have held attention for months.

TikTok Creative Center Trending Hashtags API Pro Tips

  • Save every snapshot with its country, time_range and collected_at, because a rank only has meaning inside the list it came from.
  • Reuse the same country and time_range when you send an id on to Hashtag Insights.
  • Fetch the full 100 once and filter it locally instead of repeating requests with different results_limit values, since the TikTok Creative Center Trending Hashtags API bills every request on the rows it returns.

Beyond the TikTok Creative Center Trending Hashtags API, use these APIs when you need a different type of public TikTok Creative Center data.

Explore other platforms

Combine TikTok Creative Center data with public data from other supported social platforms.

TikTok Creative Center Trending Hashtags API — FAQ

TikTok Creative Center Trending Hashtags API is a programmatic interface for retrieving the hashtags ranked as trending in a country on TikTok Creative Center over 7, 30 or 90 days. It returns each hashtag's rank, post and view counts and a daily popularity curve.

Send country as a two-letter code such as US, GB or JP; it defaults to US, and each market has its own ranking. A market without a published ranking returns zero results and is not charged.

Use 7d for what is climbing right now and 90d for tags that have held attention for months. Every window is a separate list, so the same hashtag can rank differently in each.

Up to 100 per country and window, set with results_limit (default 20). Billing follows the rows returned at 0.5 credits each, so a full 100-tag list is 50 credits.

Read the end of its popularity_curve, where values run from 0 to 100 once per day. A series that is still climbing on its last day is gaining, and one that has dropped away from an earlier high is cooling, whatever the tag's rank.

No; the TikTok Creative Center Trending Hashtags API takes country, time_range and results_limit only. To find new entries, save each day's list and compare hashtag ids with the previous one.

TikTok does not publish a refresh schedule. The popularity curve moves in daily steps and every record carries collected_at, so one request per country per day is enough to follow it.

No. A SocQ API key is the only credential the TikTok Creative Center Trending Hashtags API needs.