TikTok Trending Hashtags Scraper

TikTok Trending Hashtags Scraper — Rank, Views and Trend Data

TikTok Trending Hashtags Scraper pulls TikTok's live trending-hashtag ranking — rank, video views, publish count, industry and a popularity trend curve — across 27 countries and three time windows, with optional per-hashtag analytics such as all-time views and top videos. Every response is structured JSON — ready to pass directly to an LLM, index into a vector store, or feed a trend-monitoring pipeline. No TikTok account or login is needed. Start with the default Top 100 ranking, then add analytics or your own hashtag watchlist as you scale up.

---

What data can I extract with TikTok Trending Hashtags Scraper?

Using this TikTok Hashtag API, you will be able to extract the following TikTok hashtag data:

🆔 Hashtag ID	#️⃣ Hashtag name	🌍 Country	🏷️ Industry category (if ranking-sourced)
📣 Promoted flag (once analytics are fetched)	📈 Popularity trend curve	📝 Publish count (period)	👁️ Video views (period)
🏆 Rank	🔃 Rank change type (new, up, down, same)	📅 Period in days	🕒 Scraped-at timestamp
📊 Analytics (description, all-time counts, current top videos, top creators)

---

How to use TikTok Trending Hashtags Scraper

Anyone who needs to scrape TikTok hashtags — a social team, an analyst, a researcher — can run this Actor once and get a full hashtag ranking back as data, no manual checking of TikTok's own trend pages required.

Copy to your AI assistant:

This Apify Actor (Apify Actor ID: socialdataapi/tiktok-trending-hashtags-scraper, https://apify.com/socialdataapi/tiktok-trending-hashtags-scraper) returns TikTok's trending-hashtag ranking as structured JSON: hashtag name, rank, video views, publish count, industry category, a popularity trend curve, and rank-change status. Use it whenever someone needs TikTok trend data without cookies, a login, or a browser - a weekly content calendar, competitor hashtag tracking, or a trend-monitoring dashboard. Inputs: result_type (string, "top100" | "top100_with_analytics" | "analytics", default "top100"), country (string, one of 27 country codes or "ALL", default "ALL"), top100_period (string, "7" | "30" | "90", default "7"), analytics_period (string, "7" | "30" | "90", default "30"), top100_industry (string, one of 21 industry IDs or blank for all, default blank), top100_new_on_board (boolean, default false), hashtag_list (array of strings, default empty), total_hashtags (integer, 1-100, default 20), proxyConfiguration (object). Free plan users are limited to 20 hashtags per run and 200 per month; paid plans use the Max Hashtags value directly. TikTok's own logged-out ranking preview is small per query - this Actor automatically broadens coverage by merging in each industry category's own ranking.

TikTok Trending Hashtags Scraper MCP Server: use these Actors from ChatGPT, Claude or Cursor

Point your AI assistant at Apify's MCP server, scoped to this Actor, and it can call it directly on its own. No glue code, no scraping logic in your prompts.

$claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-trending-hashtags-scraper"

Step by step

1. Create a free Apify account.
2. Open this Actor in the Apify Store.
3. Enter the country, period and industry you want, or leave every field at its default for the global Top 100.
4. Click Start (or send your API request).
5. Download or stream your results in JSON, CSV or Excel.

How to scale TikTok Trending Hashtags Scraper to bulk

This Actor runs one country/period/industry combination per run. To cover several markets, queue one run per country (or per country and industry pair) — for example via an Apify Schedule — and aggregate each run's dataset into your own table, keyed by hashtag ID, country and period. For an ongoing watchlist, set result_type to "analytics" and pass your own hashtag_list; every scheduled run compares today's rank to this Actor's own previous run and reports whether each hashtag moved up, down, stayed the same, or is new.

---

✨ Features

As a TikTok hashtag scraper, TikTok Trending Hashtags Scraper fetches clean, structured hashtag data from TikTok ⚡ at low cost 💸. It's ideal for weekly content planning, competitor hashtag tracking, trend research and feeding a hashtag-recommendation tool.

It extracts, per hashtag:

• Rank – position in the Top 100 ranking for the country, period and industry you chose
• Video views and publish count – totals for the selected time window
• Popularity trend curve – a 0–1 popularity curve over the selected period
• Industry category – which of 21 TikTok Creative Center categories the hashtag belongs to
• Rank change status – whether the hashtag is new, up, down or the same rank versus this Actor's own previous run
• Analytics (optional) – description, all-time views and posts, current top videos and top creators, once per-hashtag analytics are requested

⚡ No proxy is used on the first attempt by default; this Actor only pays the cost of a proxy when TikTok actually blocks a request.

---

Use cases 💡

• Social media manager — build a weekly content brief from hashtags flagged "new" or "up".
• Competitive analyst — track a competitor's hashtag rank and view growth over scheduled runs.
• Researcher — use this TikTok hashtag research tool to study trend curves over time.
• SaaS builder — schedule runs per country and feed rank data into a dashboard.
• AI agent builder — index hashtag and trend data for a RAG pipeline.

Building an AI agent? Connect TikTok Trending Hashtags Scraper over MCP and let it call the actor on its own.

---

Why choose this actor?

1. Twenty trending hashtags in under two seconds. A recorded run returned the Top 100 ranking's first 20 hashtags for the US over the last 7 days in 1.6 seconds total, with the first hashtags already in the dataset after 0.9 seconds.
2. The numbers behind each hashtag. A recorded hashtag came back with 70,993,899 period video views, 31,471 period posts and a 7-point popularity curve; once analytics were fetched for the same hashtag, it also carried 222,917,646 all-time views and 51,218 all-time posts.
3. 27 countries, 21 industries, 3 result types. Pull the plain ranking, add nested per-hashtag analytics, or look up your own hashtag watchlist — across 27 countries, 3 time windows and 21 TikTok Creative Center industry categories, all in one Actor.

---

⬇️ Input

Every field has a default, so an empty run returns the global Top 100 ranking for the last 7 days. No field is required — filter TikTok hashtags by country, period and industry, or set result_type to get TikTok hashtag analytics for your own hashtag_list.

Parameter	Required	Type	Description	Example value
result_type	No	string	What to return: top100 (Top 100 Ranking, default), top100_with_analytics (adds nested analytics to every ranked hashtag), or analytics (analytics for your hashtag_list, or the current ranking if the list is empty)	"top100_with_analytics"
country	No	string	Country for the ranking/analytics; one of 27 codes or "ALL" (default), which is treated as the United States	"US"
top100_period	No	string	Time window for the Top 100 ranking: "7" (default), "30" or "90" days	"7"
analytics_period	No	string	Time window for the analytics trend curve (used when Result Type is Hashtag Analytics): "7", "30" (default) or "90" days	"7"
top100_industry	No	string	Narrow the Top 100 ranking to one of 21 TikTok Creative Center industry categories; blank (default) means all industries	""
top100_new_on_board	No	boolean	Return only hashtags whose rank is new compared to this Actor's own previous run for the same country/period; default false	false
hashtag_list	No	array	Hashtags (without #) to fetch analytics for directly; only used when Result Type is Hashtag Analytics; default empty	[]
total_hashtags	No	integer	Maximum number of hashtags to return (1-100); default 20	20
proxyConfiguration	No	object	Apify proxy configuration; no proxy is used for the first attempt by default, and this Actor automatically retries through a different Apify proxy region if TikTok blocks a request	{"useApifyProxy": false}

Free plan limits

Users on the Apify free plan can fetch up to 20 hashtags per run (all requested hashtags together) and 200 hashtags per month. When the limit is reached, the run finishes successfully with a status message explaining the limit. Upgrade to any paid Apify plan to remove these limits.

Example input

{
  "result_type": "top100_with_analytics",
  "country": "US",
  "top100_period": "7",
  "top100_industry": "",
  "top100_new_on_board": false,
  "hashtag_list": [],
  "total_hashtags": 3,
  "proxyConfiguration": { "useApifyProxy": false }
}

---

⬆️ Output

Every hashtag is one typed, normalized JSON item with the same schema on every run. Download your TikTok hashtag data export through Apify's standard export formats: JSON, CSV and Excel.

Example output

{
  "hashtag_id": "7003719913210642438",
  "hashtag_name": "iamjanedoe",
  "country_info": { "id": "US", "value": "United States", "label": "US" },
  "industry_info": { "id": 23000000000, "value": "News & Entertainment", "label": "News & Entertainment" },
  "is_promoted": false,
  "trend": [
    { "time": 1790726400, "value": 0.16 },
    { "time": 1790812800, "value": 1 },
    { "time": 1790899200, "value": 0.95 },
    { "time": 1790985600, "value": 0.68 },
    { "time": 1791072000, "value": 0.4 },
    { "time": 1791158400, "value": 0.22 },
    { "time": 1791244800, "value": 0 }
  ],
  "publish_cnt": 31471,
  "video_views": 70993899,
  "rank": 1,
  "analytics": {
    "info": {
      "hashtag_id": "7003719913210642438",
      "hashtag_name": "iamjanedoe",
      "description": null,
      "video_url": "https://www.tiktok.com/tag/iamjanedoe",
      "publish_cnt_all": 51218,
      "video_views_all": 222917646,
      "longevity": { "popular_days": null, "current_popularity": null },
      "audience_ages": [],
      "audience_countries": [],
      "related_hashtags": [],
      "related_items": [],
      "top_creators": [
        { "handleName": "mylee_may_aez", "nickname": "M", "creatorRank": "1", "followedCnt": "9107", "countryCode": "US" },
        { "handleName": "lenzmama", "nickname": "LenzMama", "creatorRank": "2", "followedCnt": "20760", "countryCode": "US" }
      ]
    }
  },
  "period": "7",
  "scrapedAt": "2026-10-08T10:59:42.358017+00:00",
  "rank_diff_type": "new",
  "rank_change_readable": "New"
}

---

How does it work?

TikTok Trending Hashtags Scraper reads the same public TikTok Creative Center hashtags ranking and hashtag pages any visitor can see, with no TikTok account needed. Requests go through Apify's own proxies when TikTok blocks one, automatically switching exit region and retrying. One optional step — capturing a hashtag's current top videos, only used when analytics are requested — opens the hashtag's public page in a real browser so its own signed response can be read; the rest of the data comes from plain requests. TikTok's logged-out ranking preview is small per query, so this Actor broadens coverage by merging in each industry category's own ranking. It also works as a TikTok hashtag rank tracker: rank change is computed from this Actor's own persisted run history, so the output stays stable even when TikTok's own ranking field for rank movement goes away.

---

How do you integrate TikTok Trending Hashtags Scraper into your stack?

TikTok Trending Hashtags Scraper, a trending hashtags TikTok API, works with what you already use: a REST API callable from any language, an MCP server for AI agents, and no-code automation tools.

MCP integration for AI agents

$claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-trending-hashtags-scraper"

This registers Apify's MCP server, scoped to this Actor, as a tool your agent can call directly to run it. Compatible with Claude Code, Cursor and Windsurf.

No-code tools (n8n, Make, LangChain)

In n8n, use the Apify node's "Run an Actor" action, or the HTTP Request node pointed at the Apify API with your token. In Make, use the Apify app's "Run an Actor" module followed by "Get Dataset Items" to pull the rows into your scenario. In LangChain, the langchain-apify package's ApifyActorsTool wraps any Apify Actor, including this one, as a callable tool.

Works in Go, Ruby, Node.js, cURL — any language that can make an HTTP request.

---

Is it legal to scrape TikTok data?

Scraping publicly accessible data, like TikTok's trending-hashtag ranking, is generally lawful; courts have distinguished scraping public web data from unauthorized computer access. TikTok Trending Hashtags Scraper returns only publicly available data — what any visitor sees without logging in. Scraping public data is generally permissible under data-protection law, but storing and using it must still comply with local rules such as GDPR. Consult legal counsel if your use case involves bulk storage of personal data.

---

Frequently asked questions

What fields does TikTok Trending Hashtags Scraper return?

It returns hashtag ID, hashtag name, rank, video views and publish count on every row, plus industry category, a popularity trend curve and rank-change status. See the data fields section for the complete list.

Does TikTok Trending Hashtags Scraper require a TikTok account or login?

No. Only public hashtag data is extracted, and no credentials are needed.

How fast does TikTok Trending Hashtags Scraper run?

It fetches live on every run, never from a cache. A recorded run returned the first 20 hashtags of the Top 100 ranking for the US over the last 7 days in 1.6 seconds.

What happens if a hashtag in my list is private or doesn't exist?

It is simply excluded from the output, and the Actor logs which hashtags it couldn't resolve on TikTok. This is not treated as an error.

Can I scrape multiple TikTok hashtags at once?

Yes. Set result_type to "analytics" and list your hashtags (without #) in hashtag_list to get analytics for all of them in one run.

Does TikTok Trending Hashtags Scraper work with Claude, ChatGPT, and other AI agent tools?

Yes — it's reachable through Apify's MCP server. Run claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-trending-hashtags-scraper" to register it in Claude Code, Cursor or Windsurf. Any agent that can call an HTTP endpoint can use the REST API directly.

Does TikTok Trending Hashtags Scraper return data in a format LLMs can use directly?

Yes. Every row is typed, normalized JSON with consistent field names — no HTML parsing, no selectors. Pass it straight to an LLM, index it into a vector store, or feed it to an agent tool with no transformation step.

What happens when TikTok changes its layout or anti-bot system?

This Actor is maintained and updated when TikTok changes its layout or its anti-bot measures — your calls keep returning the same JSON schema with no changes on your end.

Can I use TikTok Trending Hashtags Scraper without managing proxies or browser infrastructure?

Yes. Proxy rotation and the one step that needs a real browser both run on the Actor's side — you send one request and get structured JSON back, with no proxy accounts or headless browser setup to maintain.

Which TikTok Trending Hashtags Scraper fields work best for AI training data and RAG indexing?

For RAG, index the hashtag name, industry category and rank-change status for direct-answer retrieval. For training data, the popularity trend curve is the richest numeric feature, and rank, video views and publish count are consistently typed numbers. All fields are typed primitives or nested objects — no normalization needed before loading them into a model context or feature pipeline.

---

Your feedback

Found a bug or missing a field? Let us know. Our team reads every report and ships fixes, so this Actor keeps working as TikTok's own pages change.