TikTok Hashtag Trends Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Track trending TikTok hashtags from the Creative Center at ads.tiktok.com/business/creativecenter/hashtag. Returns ranked hashtags with post count, total video views, and a time-series popularity curve showing trend momentum. Supports any country available in TikTok Creative Center. Note: the public unauthenticated endpoint caps results at 3 hashtags per request.

What this actor does

• Fetches trending hashtags from TikTok's Creative Center trends API
• Returns rank position, post count, video views, and a popularity curve per hashtag
• Filters by country (any ISO 2-letter code supported by Creative Center) and time period
• Records observedCountry and observedPeriod on each row for dataset provenance
• Exits cleanly with a log message if TikTok restricts access from the current IP — no crash or error rows
• Empty fields are omitted

Output per hashtag

• hashtagId — TikTok's internal hashtag identifier
• hashtagName — hashtag text without the # symbol
• publishCnt — number of videos published using this hashtag in the observed period
• rankIndex — rank position in the trending list (1 = most trending)
• popularityCurve — array of { time, value } data points showing trend momentum over the period
• vv — total video views on content using this hashtag
• observedCountry — country code used for this query
• observedPeriod — time period in days used for this query
• scrapedAt — ISO 8601 timestamp of collection

Input

Example: Top 3 trending hashtags in the US this week

{
"country":"US",
"period":"7",
"maxRanks":3
}

Example: 30-day trends in the UK

{
"country":"GB",
"period":"30",
"maxRanks":3
}

Example: Long-term trends in Japan

{
"country":"JP",
"period":"180",
"maxRanks":3
}

Example: Weekly trends in Brazil

{
"country":"BR",
"period":"7",
"maxRanks":3
}

Use cases

• Content strategy — identify the hashtags driving the most views right now in your target market and incorporate them into upcoming posts
• Campaign timing — monitor the popularity curve to catch hashtags at the start of their upward trend before they peak
• Market research — compare trending hashtags across countries to understand regional audience interests and cultural moments
• Influencer briefing — provide creators with a weekly top-3 list of trending hashtags in their niche or geography
• Competitor benchmarking — track whether your brand or category hashtags appear in the trending list over time

FAQ

Q: Why does the actor only return 3 hashtags?
A: TikTok's public Creative Center endpoint caps unauthenticated requests at 3 hashtags per query. This is a platform-level limit, not an actor limitation.

Q: What countries are supported?
A: Any country code recognized by TikTok Creative Center, including US, GB, JP, KR, BR, DE, FR, ID, TH, VN, PH, AU, CA, MX, and many more.

Q: How often should I run this actor?
A: For daily trend monitoring, run once per day. TikTok updates Creative Center trends on a daily cycle.

Q: How do I monitor multiple countries?
A: Run the actor once per country. Each run is fast (only 3 results), so monitoring 10–20 countries daily is practical.

Q: What is the popularityCurve field?
A: An array of { time, value } data points that shows how the hashtag's popularity score changed over the selected period. Use it to determine whether a hashtag is rising, peaked, or declining.

Q: What is publishCnt vs vv?
A: publishCnt is the number of new videos posted with the hashtag during the period. vv is the total view count accumulated on those videos. A hashtag with low publishCnt but high vv indicates high per-video virality.

Q: What happens if no data is returned?
A: TikTok occasionally restricts Creative Center API access from certain datacenter IP ranges. When this occurs, the actor logs a clear message and exits cleanly without pushing error rows.

Related TikTok Scrapers

Build a complete TikTok data pipeline with our full suite: