tiktok-creative-center/
trending-hashtag-detail

The TikTok Creative Center Hashtag Insights API looks up one trending TikTok hashtag by Creative Center ID: post and view counts, a daily popularity curve, top countries by score and example video IDs.

TikTok Creative Center Hashtag Insights API

Hashtag ID input
Top countries
Example videos
0.5 credits / request
Ready
README

By SocQ · Updated

TikTok Creative Center Hashtag Insights

A Creative Center hashtag insight profiles one trending tag in a market: its post and view counts, a daily popularity curve, the countries where it is most popular relative to their size, and example videos that use it. Together they show how a trend is moving, where else it resonates and what kind of content carries it.

TikTok Creative Center Hashtag Insights API Features

  • One tag, looked up by IDhashtag_id takes the id of a Trending Hashtags result and returns a single record for that tag in the chosen country and time_range.
  • Curve and counts for the windowpopularity_curve gives one dated value per day from 0 to 100, with metrics.posts_count and metrics.views_count beside it.
  • Countries ranked by scoretop_countries lists country_code and score, highest first, where the score reflects popularity relative to the country's size.
  • Example video IDsvideo_ids lists videos that use the tag, showing what content the trend is built on.

TikTok Creative Center Hashtag Insights API Parameters

ParametersRequiredDescription
hashtag_idRequiredHashtag ID from a TikTok Creative Center Trending Hashtags result.
countryOptionalTwo-letter country code of the market, such as US, GB or JP. Defaults to US.
time_rangeOptionalPeriod to analyze: 7d (default), 30d or 90d.

How to Use the TikTok Creative Center Hashtag Insights API

Take a hashtag ID from the trending ranking and read its insight through the TikTok Creative Center Hashtag Insights API.

  1. Collect hashtags with TikTok Creative Center Trending Hashtags and copy an id.
  2. POST {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} to /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded and read the single record in results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

TikTok Creative Center Hashtag Insights API Use Cases

  • Go or no-go check on a trend: Read popularity_curve and the counts in metrics from the TikTok Creative Center Hashtag Insights API before committing a campaign to a tag, and check whether the curve is still rising on its last day.
  • Screening markets for expansion: Use top_countries to see which other countries score highest for a tag that is trending at home, and shortlist them for localized posts.

TikTok Creative Center Hashtag Insights API Pro Tips

  • Pass the TikTok Creative Center Hashtag Insights API the same country and time_range as the ranking the id came from, so the figures describe the list you picked the tag from.
  • Do not read top_countries as a ranking by volume: the score is relative to country size, so a small market can sit above a large one.

Beyond the TikTok Creative Center Hashtag Insights 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 Hashtag Insights API — FAQ

TikTok Creative Center Hashtag Insights API is a programmatic interface for retrieving the insight record of one trending TikTok hashtag, identified by its Creative Center ID, country and time range. It returns post and view counts, a daily popularity curve, top countries by score and example video IDs.

From the id field of a Trending Hashtags result, taken from the ranking of the country you will query. It is a numeric string of 5 to 32 digits, and any other format is rejected with a 400 error.

Not here, because the TikTok Creative Center Hashtag Insights API accepts only the numeric ID. To get the video count and total views of a tag by name, use the TikTok Hashtag Views API.

top_countries and video_ids, which are null in ranking rows. rank is null here because a position belongs to the ranking, so keep the rank from the Trending Hashtags result.

It measures how popular the hashtag is in that country relative to the country's size, and the list is sorted from highest score down. A small market can therefore outrank a large one.

The task fails with a full refund. A successful request is billed once at 0.5 credits, however many video_ids come back.