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
| Parameters | Required | Description |
|---|---|---|
hashtag_id | Required | Hashtag ID from a TikTok Creative Center Trending Hashtags result. |
country | Optional | Two-letter country code of the market, such as US, GB or JP. Defaults to US. |
time_range | Optional | Period 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.
- Collect hashtags with TikTok Creative Center Trending Hashtags and copy an id.
- POST {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} to /v1/tiktok-creative-center/trending-hashtag-detail.
- 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.
Related APIs
Beyond the TikTok Creative Center Hashtag Insights API, use these APIs when you need a different type of public TikTok Creative Center data.
- TikTok Creative Center Top Ads API — Browse top-performing ads by keyword and period, with captions, CTR, likes, and the ad video.
- TikTok Creative Center Ad Analysis API — Break one top ad down second by second with click-through and retention curves.
- TikTok Creative Center Trending Hashtags API — Get a country's trending hashtag ranking with post counts, views, and popularity curves.
- TikTok Creative Center Top Videos API — Get a country's chart of top-performing videos with views and engagement rates.
- TikTok Creator Marketplace API — Get Creator Marketplace cards with follower demographics, median views, and starting rates.