Tiktok Trending Hashtags Analytics Scraper

TikTok Trending Hashtags Analytics Scraper — Rankings, Trend Curves & Top Creators

Pull TikTok's Top 100 trending hashtags for any of 76 countries (or globally), enrich each one with per-hashtag analytics — video views, publish counts, trend curves over time and top creators — or feed in your own hashtag list and get analytics for those instead.

Filter by industry, isolate hashtags that just entered the chart, and choose how deep the trend history goes.

---

What is TikTok Trending Hashtags Analytics Scraper?

TikTok publishes hashtag rankings in its Creative Center, but as a browsing interface: no export, no history, no way to compare markets.

This Actor turns that into data, with three distinct modes so you only pay for the depth you need:

Mode	What it does	When to use it
top100	Ranking only — fast, no analytics calls	Cheap monitoring; you just need the list
top100_with_analytics	Ranking plus per-hashtag deep dive: views, publishes, trend curves, top creators	Research and reporting
analytics	Analytics for your own hashtag list	Validating hashtags you already care about

The analytics mode also carries a genuinely useful constraint worth knowing up front: your hashtags are resolved against the live trending list for the country and window you chose. Hashtags not currently on that list are skipped — which is a TikTok limitation, and itself a signal about how much traction a hashtag has.

---

What data can you extract?

Ranking rows

Field	Description
hashtag_name	The hashtag, without #
hashtag_id	TikTok's internal identifier
rank	Position in the Top 100
video_views	Views on videos using the hashtag in the period
publish_cnt	Number of videos published with it

Analytics rows

Each row carries hashtag_id, hashtag_name and an analytics object containing TikTok's detailed statistics over your chosen analytics window — including trend history curves and top creators using the hashtag.

---

Why teams scrape trending hashtags

For content planning

A hashtag ranking is only half the story. video_views against publish_cnt tells you whether a hashtag is high demand with low supply — the combination worth posting into — or already saturated.

For catching trends early

The new-on-board filter returns only hashtags that just entered the chart. A trend you catch on entry is worth several times one you catch at peak.

For campaign validation

Before committing a campaign to a hashtag, run analytics mode on it. If TikTok returns no data because it is not on the trending list, that is a clear answer.

For competitive and category research

The industry filter narrows the chart to your vertical, so a beauty brand reads beauty trends rather than gaming ones.

For localisation

76 countries plus a global view means you can compare which hashtags trend where before launching in a new market.

For creator discovery

The analytics payload includes top creators using each hashtag — a discovery route tied directly to a trend rather than to follower counts.

---

How to scrape trending hashtags step by step

1. Open the Actor and pick a Result type — start with top100 to see the chart cheaply.
2. Choose a Country and a Top 100 ranking period (7, 30 or 120 days).
3. (Optional) Add an industry filter or turn on New to Top 100 only.
4. Set Max hashtags to fetch (1–500 for Top 100 modes).
5. For analytics mode, add your hashtags to Custom hashtag list and set an analytics period.
6. Click Start, then export the Output tab as JSON (recommended for analytics modes).

---

⬇️ Input

Example input — this week's breakout hashtags

{
  "result_type": "top100",
  "country": "US",
  "top100_period": "7",
  "top100_new_on_board": true,
  "total_hashtags": 100
}

Example input — ranking with full analytics

{
  "result_type": "top100_with_analytics",
  "country": "GB",
  "top100_period": "30",
  "top100_industry": "Beauty & Personal Care",
  "analytics_period": "120",
  "total_hashtags": 50
}

Example input — validate your own hashtags

{
  "result_type": "analytics",
  "country": "US",
  "analytics_period": "365",
  "hashtag_list": ["yourbrand", "yourcampaign", "yourproduct"]
}

Input reference

Field	Type	Default	Description
result_type	string	top100_with_analytics	top100 (ranking only), top100_with_analytics (ranking + per-hashtag analytics), analytics (your own hashtag list).
country	string	US	One of 76 country codes, or ALL for global. Feeds both the ranking and the analytics calls.
top100_period	string	7	Ranking window: 7, 30 or 120 days. TikTok accepts only these three.
analytics_period	string	30	Trend-curve depth: 7, 30, 120, 365 or 1095 days. More days means a richer history curve.
top100_industry	string	—	Industry slice of the leaderboard, fuzzy-matched to TikTok's buckets: Apparel & Accessories, Baby/Kids & Maternity, Beauty & Personal Care, Business Services, Education, Financial Services, Food & Beverage, Games, Healthcare, Home Improvement, Household Products, Life Services, News & Entertainment, Pets, Real Estate, Software & Apps, Sports & Outdoor, Tech & Electronics, Travel, Vehicle & Transportation.
top100_new_on_board	boolean	false	Top 100 modes only — return only hashtags that newly entered the chart in your window.
hashtag_list	array	[]	Your own hashtags, without #. Resolved against the live trending list for your country and window; ones not currently listed are skipped.
total_hashtags	integer	10	Cap of 1–500 for Top 100 modes. In pure analytics mode with a hashtag_list, the cap does not apply — your list governs.
proxyConfiguration	object	Apify Proxy on	Pick datacenter or residential groups, or supply your own proxy URLs. Residential works best with TikTok.

---

⬆️ Output

Example output — ranking row

{
  "hashtag_name": "morningroutine",
  "hashtag_id": "3915301",
  "rank": 7,
  "video_views": 184300000,
  "publish_cnt": 42180,
  "analytics": {}
}

Example output — with analytics

{
  "hashtag_id": "3915301",
  "hashtag_name": "morningroutine",
  "video_views": 184300000,
  "publish_cnt": 42180,
  "rank": 7,
  "analytics": {
    "trend": [
      { "time": 1785600000, "value": 0.42 },
      { "time": 1786204800, "value": 0.61 }
    ],
    "creators": [
      { "nickName": "Example Creator", "avatarUrl": "https://…" }
    ]
  }
}

Illustrative values — a live run returns current TikTok data.

---

Usage recipes

Cheap weekly monitoring

{
  "result_type": "top100",
  "country": "US",
  "top100_period": "7",
  "total_hashtags": 100
}

Ranking-only mode makes no analytics calls, so it is the fastest and cheapest way to keep an eye on the chart.

Catch trends on entry

Add "top100_new_on_board": true to the above. Anything returned has just climbed onto the chart.

Vertical deep dive

{
  "result_type": "top100_with_analytics",
  "country": "DE",
  "top100_industry": "Food & Beverage",
  "top100_period": "30",
  "analytics_period": "120",
  "total_hashtags": 50
}

Find under-supplied hashtags

Export a ranking and compute video_views ÷ publish_cnt. High values mean a lot of attention spread across relatively few videos — the best place to post.

Validate campaign hashtags

{
  "result_type": "analytics",
  "country": "US",
  "analytics_period": "365",
  "hashtag_list": ["yourbrand", "yourcampaign"]
}

If a hashtag returns nothing, it is not currently on the trending list — a real answer, not an error.

Compare markets

Run the same configuration across several countries and compare which hashtags appear in each.

---

How does this compare to TikTok's official API?

TikTok's Research API is restricted to approved academic and non-profit researchers in eligible regions. The Display API covers a user's own authorised content, and the Commercial Content API covers ad transparency. None of them expose Creative Center's hashtag rankings or trend analytics.

This Actor reads the public Creative Center hashtag data that TikTok publishes for marketers — no application, no key, no eligibility test.

---

Integrate and automate

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_API_TOKEN>")

run = client.actor("scraperforge/tiktok-trending-hashtags-analytics-scraper").call(run_input={
    "result_type": "top100",
    "country": "US",
    "top100_period": "7",
    "top100_new_on_board": True,
    "total_hashtags": 100,
})

for h in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(h.get("rank"), "#" + str(h.get("hashtag_name")), h.get("video_views"), h.get("publish_cnt"))

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_API_TOKEN>' });

const run = await client.actor('scraperforge/tiktok-trending-hashtags-analytics-scraper').call({
    result_type: 'top100',
    country: 'US',
    top100_period: '7',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

REST API

curl -X POST "https://api.apify.com/v2/acts/scraperforge~tiktok-trending-hashtags-analytics-scraper/runs?token=<YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"result_type":"top100","country":"US","top100_period":"7"}'

n8n, Make, Zapier and AI agents

Call the Actor from n8n, Make, Zapier or an MCP-capable agent — a weekly trend digest posted to Slack is the obvious build.

Schedules and webhooks

Attach a Schedule to build trend history over time, and use webhooks or the Google Sheets / Airtable / Slack integrations to deliver it.

---

Pricing and what you are charged for

Pay-per-event: a small Actor-start charge plus a charge per hashtag row delivered.

The mode is the cost lever. top100 performs no analytics calls and is dramatically lighter than top100_with_analytics, which makes an extra request per hashtag. Use ranking-only for monitoring and switch to analytics when you are ready to dig in.

Current rates are on the Pricing tab of this Actor's page, and Apify shows an estimate before and during every run.

---

Limits, reliability and blocking

• The Top 100 is exactly 100 hashtags per country / period / industry combination. Narrow by industry to get 100 relevant hashtags rather than 100 general ones.
• Only three ranking periods exist — 7, 30 and 120 days. That is TikTok's constraint.
• Custom hashtags are resolved against the live trending list. A hashtag with insufficient traction in your chosen country and window returns nothing. That is expected behaviour and a useful signal.
• total_hashtags does not apply in pure analytics mode — your hashtag_list governs.
• Analytics mode is slower: one lookup per hashtag on top of the ranking.
• Two independent periods. top100_period decides which hashtags rank; analytics_period decides how far back the curves reach.
• Rank movement is relative to the selected period — changing the window changes what counts as "new".
• Residential proxy works best. TikTok tolerates it far better than datacenter traffic.
• Default run options are 4 GB memory and a 1-hour timeout.

---

Is it legal to scrape TikTok trending hashtags?

This Actor collects publicly published aggregate trend data — hashtag statistics TikTok makes available to marketers and researchers through its Creative Center. It involves no login, no private content and, for ranking data, no personal data at all.

The analytics payload can include creator names and avatars among top creators; treat those as personal data under GDPR and comparable regimes if you store them. Otherwise this is aggregate statistics. You are responsible for ensuring your use complies with TikTok's terms and applicable law.

---

❓ Frequently asked questions

Which result type should I use?

top100 for cheap, fast monitoring. top100_with_analytics when you need trend curves and creators. analytics when you already know which hashtags you care about.

How do I find trends before they peak?

Set top100_period to 7 and enable top100_new_on_board.

Why did my custom hashtag return nothing?

Because it is not on the live trending list for the country and window you selected. TikTok only serves analytics for hashtags currently on that list.

What is the difference between the two period settings?

top100_period controls which hashtags appear in the ranking; analytics_period controls how far back the trend curves go. They are independent by design.

Can I filter by industry?

Yes — 20 TikTok Creative Center industry buckets, fuzzy-matched from readable names.

How many hashtags can I get?

Up to 500 in Top 100 modes (though the chart itself is 100 per combination). In analytics mode, your hashtag list sets the count.

Does it include creators?

Yes — the analytics payload includes top creators using each hashtag.

Do I need a proxy?

Residential is recommended and works best with TikTok. The proxy section lets you choose groups or supply your own URLs.

Which export format should I use?

JSON for analytics modes, since analytics is a nested object with curves and creators. CSV is fine for ranking-only runs.

---

🔗 Related scrapers

• TikTok Trending Hashtags Scraper — the lighter sibling with the same three modes.
• TikTok Trending Creator Insights Scraper — deep analytics on the creators driving these hashtags.
• Scrape TikTok Trending Videos — the video charts behind the hashtag trends.
• TikTok Search Scraper — pull actual videos for a hashtag once you have picked one.

Browse the full collection on the ScraperForge profile.

---

💬 Feedback

Need more history, extra metrics, or a custom trend-monitoring pipeline? Open an issue on the Issues tab of this Actor.