Tiktok Trending Hashtags Analytics Scraper

TikTok Trending Hashtags Analytics Scraper — Ranks, Views, Top Videos

TikTok Trending Hashtags Analytics Scraper pulls TikTok Creative Center's trending hashtags for a country and time window: rank, video views, posts, daily popularity curve, industry and top creators, plus all-time views, top videos and any description. About 55 hashtags per board, from the overall chart and every industry chart. Every response is structured JSON — ready to pass directly to an LLM, index into a vector store, or feed a social listening pipeline. No TikTok account or cookies needed. Pick a country and start tracking what trends next.

---

What data can I extract with TikTok Trending Hashtags Analytics Scraper?

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

🏷️ Hashtag name	🏆 Rank	👀 Video views (window)	📝 Posts (window)
🆔 Hashtag ID	🏭 Industry	📈 Daily popularity curve	👤 Top creators (3)
🧾 Description (if available)	💰 Promoted flag	🌍 All-time posts	📊 All-time video views
🎬 Top videos (about 30) with covers	🔗 Hashtag page link	📍 Country served	📅 Window served
🗓️ Curve start and end dates	🧮 Views and posts as numbers	✅ Coverage flags	⏱️ Scraped at

---

How to use TikTok Trending Hashtags Analytics Scraper

Built for marketers, analysts and AI builders who want TikTok trends as data: this TikTok trending hashtags scraper turns a country and a time window into a ranked list of trending hashtags with their numbers and top videos.

Copy to your AI assistant:

This actor (Apify Actor ID: socialdataapi/tiktok-trending-hashtags-analytics-scraper, https://apify.com/socialdataapi/tiktok-trending-hashtags-analytics-scraper) is an Apify Actor that returns the trending hashtags TikTok Creative Center shows for one country and time window as structured JSON: hashtag name and ID, rank, video views and posts in the window, industry, daily popularity curve, top creators, and in the analytics modes the hashtag's description, promoted flag, all-time posts and views and its top videos. Use it whenever someone needs TikTok trending hashtags without cookies, a login, or a browser - picking hashtags for a campaign, tracking which topics rise in a market, or feeding trend data to an AI agent. Inputs: result_type (string, "top100" | "top100_with_analytics" | "analytics", default "top100_with_analytics"), country (string, country code such as "US" | "GB" | "JP"; 27 countries have a board and every other code gets the US board, default "US"), top100_period (string, board window in days, "7" | "30" | "90" | "120", where 120 is served as 90, default "7"), analytics_period (string, kept for older inputs and has no effect, default "30"), top100_industry (string, one industry such as "Games" or "Beauty & Personal Care" to get only that industry's trending hashtags, empty for the full board, default ""), top100_new_on_board (boolean, has no effect, default false), hashtag_list (array of strings, used only with result_type "analytics" to return only those hashtags if they are on the board, default []), total_hashtags (integer 1-500, maximum hashtag rows to save, default 10), proxyConfiguration (object, Apify Proxy or your own proxy, default Apify Proxy). Each hashtag row has rowType "hashtag" and is charged as the row_result event; when a run finds nothing to return it saves one free row with rowType "accounting" and an error reason and message instead. A board holds about 55 hashtags (TikTok shows about 3 per chart without a login, across the overall chart and every industry chart); description, all-time totals and top videos are filled only in the analytics result types, and fields TikTok does not show without a login (audience, related hashtags, longevity) stay empty.

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

Point your AI assistant at Apify and it can read TikTok on its own: trending hashtags by country and industry with their views, posts, popularity curves and top videos. No glue code, no scraping logic in your prompts.

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

Step by step

1. Create a free Apify account.
2. Open TikTok Trending Hashtags Analytics Scraper in the Apify Store.
3. Pick the TikTok country, the time window and, if you want, one industry or your own hashtag list.
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 Analytics Scraper to bulk

One run reads one board: a country and a time window. To cover several markets, start one run per country (and per window) from the API or from a schedule in Apify Console, and merge the datasets on the hashtag name. A board-only run returned all 57 US hashtags in under 3 seconds, so a daily sweep of all 27 countries stays small. Rows are saved as each hashtag is finished, so you can read the dataset while a run is still going.

---

✨ Features

TikTok Trending Hashtags Analytics Scraper fetches clean, structured trending hashtags from TikTok Creative Center ⚡. It's ideal for campaign hashtag research, spotting rising topics in a market, comparing industries and feeding trend context to AI agents — a TikTok hashtag research tool that runs on a schedule. It extracts, per hashtag:

• Rank – TikTok's position for the hashtag, overall or inside its industry chart
• Video views and posts – activity in the selected 7, 30 or 90-day window
• Popularity curve – one point per day, with first and last dates
• Top videos – about 30 TikTok hashtag top videos per hashtag, with cover images
• All-time totals – every post and view the hashtag has collected
• Industry and top creators – the industry chart it trends in and its 3 top creators

⚡ No TikTok account or cookies needed. Ranking-only runs finish in seconds; full TikTok hashtag analytics takes a few minutes per board.

---

Use cases 💡

• Social media manager — pick this week's TikTok popular hashtags by country before posting.
• Brand marketer — track which hashtags trend in your industry chart every 30 days.
• Market analyst — use it as a TikTok hashtag views scraper to compare views and posts across countries.
• Content creator — study each hashtag's top videos before joining a trend.
• AI engineer — feed daily TikTok hashtag trends into a RAG index for an agent.

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

---

Why choose this actor?

1. The whole trending board, in seconds. A recorded board-only run returned all 57 trending US hashtags for the last 7 days in 2.6 seconds, and the same board with full analytics and top videos finished in about 3.5 minutes.
2. The numbers behind each hashtag. A recorded #waterwipes row came back ranked 1st in Baby, Kids & Maternity with 39,380,186 views and 43,990 posts in 30 days, 308,420,305 all-time views, 30 daily curve points and 30 top videos.
3. 3 result types, 27 countries, 19 industry charts. Board ranking only, ranking with analytics, or analytics for your own hashtag list, for any of the 27 countries TikTok publishes trends for, across 7, 30 or 90 days.

---

⬇️ Input

The actor needs no required field: pick a country and a time window, or keep the defaults (United States, 7 days). One run reads one board.

Parameter	Required	Type	Description	Example value
result_type	No	string	What to return: top100 (ranking only), top100_with_analytics (ranking plus analytics, top videos and totals) or analytics (analytics for the whole board or your hashtag list). Default top100_with_analytics.	top100_with_analytics
country	No	string	Country code. 27 countries have a TikTok trending board: US FR DE IT ES GB AR AU BR CA CO EG ID IL JP KR MY MX PH SA SG ZA TW TH TR AE VN; any other code in the list gets the US board and the rows say so. Default US.	GB
top100_period	No	string	Board window in days: 7, 30, 90 or 120 (120 is served as 90). Default 7.	30
analytics_period	No	string	Kept for older inputs; it has no effect. Default 30.	30
top100_industry	No	string	One industry, for example Games or Beauty & Personal Care, to get only that industry's trending hashtags. Empty returns the full board. Real Estate has no TikTok chart and returns the full board. Default empty.	Games
top100_new_on_board	No	boolean	Kept for older inputs; it has no effect. Default false.	false
hashtag_list	No	array	Hashtag names without #. Used only with result type analytics: only these hashtags are returned if they are on the board. Default empty.	["messi", "dell"]
total_hashtags	No	integer	Maximum hashtag rows to save, 1-500. A board holds about 55. Default 10.	50
proxyConfiguration	No	object	Apify Proxy (residential when no group is chosen) or your own proxy URLs. Default Apify Proxy.	{"useApifyProxy": true}

Free plan limits

Free plan: up to 20 hashtags per run and 200 per month; paid plans have no limit. Paid plans, local apify runs and Apify's own test runs are never limited.

Example input

{
  "result_type": "top100_with_analytics",
  "country": "US",
  "top100_period": "30",
  "analytics_period": "30",
  "top100_industry": "",
  "top100_new_on_board": false,
  "hashtag_list": [],
  "total_hashtags": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Only the hashtags you list, with full analytics:

{
  "result_type": "analytics",
  "country": "US",
  "top100_period": "7",
  "hashtag_list": ["messi", "dell", "amazonprimeday"],
  "total_hashtags": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

---

⬆️ Output

Every hashtag is one typed, normalized JSON item with the same fields on every run; the ranking-only result type leaves the analytics object empty. Export the dataset as JSON (default), CSV or Excel. When a run has nothing to return (the board is empty, none of your hashtags are on it, or TikTok does not answer), it saves one free accounting row that explains why.

Example output

A recorded row from a top100_with_analytics run (US, 30 days), with the curve, creators and top videos shortened to the first entries:

[
  {
    "hashtag_id": "1654822581474310",
    "hashtag_name": "waterwipes",
    "video_views": "39380186",
    "publish_cnt": "43990",
    "rank": 1,
    "industry_info": { "id": 12000000000, "value": "Baby, Kids & Maternity", "label": "label_12000000000" },
    "rank_diff_type": null,
    "analytics": {
      "video_views": "39380186",
      "publish_cnt": "43990",
      "rank": "1",
      "industry_ids": ["14000000000", "12000000000"],
      "trend": [
        { "timestamp": "1789084800", "value": 1.533362705955463 },
        { "timestamp": "1789171200", "value": 3.7598997292367424 }
      ],
      "creators": [
        { "aioCreatorID": "", "avatarURL": "https://p16-common-sign.tiktokcdn.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:300:300.jpeg?dr=14577&refresh_token=02aa23de&x-expires=1791979200&x-signature=vMVsxdER8aL7HNFpKNKljycnGXE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=429d27ce&idc=my", "countryCode": "US", "creatorRank": "1", "followedCnt": "303", "handleName": "user7248180606250", "nickname": "user7248180606250", "ttUID": "7672035473053811725" }
      ],
      "info": {
        "hashtag_id": "1654822581474310",
        "hashtag_name": "waterwipes",
        "description": null,
        "video_url": "https://www.tiktok.com/tag/waterwipes",
        "country_info": { "id": "US", "value": "United States", "label": "US" },
        "industry_info": { "id": 12000000000, "value": "Baby, Kids & Maternity", "label": "label_12000000000" },
        "is_promoted": false,
        "trend": [
          { "time": 1789084800, "value": 0.02 },
          { "time": 1789171200, "value": 0.04 }
        ],
        "publish_cnt": 43990,
        "video_views": 39380186,
        "publish_cnt_all": 62923,
        "video_views_all": 308420305,
        "longevity": { "popular_days": null, "current_popularity": null },
        "audience_ages": [],
        "audience_countries": [],
        "related_hashtags": [],
        "related_items": [
          { "item_id": 7659894021740956672, "cover_uri": "https://p19-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/oYoIRPriCBaJByJNOqiBwQIiIA5GGdkfCVA1lr~tplv-tiktokx-origin.image?dr=9636&x-expires=1791979200&x-signature=%2BGrp%2BxN%2FtbSQA8TlXGubDZXAHow%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5" },
          { "item_id": 7645114190281165824, "cover_uri": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ownIcfGzgLAug1CMIQIkMmIiHTcVejzjUwehAn~tplv-tiktokx-origin.image?dr=9636&x-expires=1791979200&x-signature=AvCci69T5r3fQu1mZIjAe44hp9s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5" }
        ]
      }
    },
    "videoViewsInt": 39380186,
    "publishCntInt": 43990,
    "rankInt": 1,
    "industryIds": ["14000000000", "12000000000"],
    "industryIdCount": 2,
    "trendPointCount": 30,
    "trendComplete": true,
    "trendFirstDate": "2026-09-11",
    "trendLastDate": "2026-10-10",
    "creatorCount": 3,
    "topCreatorHandles": "user7248180606250, skyward960, poppybrittany",
    "rowType": "hashtag",
    "resultType": "top100_with_analytics",
    "regionRequested": "US",
    "regionUsed": "US",
    "regionName": "United States",
    "countrySupported": true,
    "countryFallbackApplied": false,
    "periodRequested": 30,
    "periodUsed": 30,
    "periodAliasApplied": false,
    "analyticsPeriodRequested": "30",
    "analyticsPeriodSupported": false,
    "industryRequested": null,
    "industryFilterSupported": true,
    "newOnBoardRequested": false,
    "newOnBoardSupported": false,
    "totalHashtagsRequested": 10,
    "boardRowsAvailable": 10,
    "boardTotalCount": 3,
    "sourceUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag",
    "scrapedAt": "2026-10-12T12:07:02.507364+00:00",
    "errorReason": null,
    "errorMessage": null
  },
  {
    "hashtag_id": null,
    "hashtag_name": null,
    "video_views": null,
    "publish_cnt": null,
    "rank": null,
    "industry_info": null,
    "rank_diff_type": null,
    "analytics": {},
    "rowType": "accounting",
    "resultType": "analytics",
    "regionUsed": "US",
    "periodUsed": 7,
    "errorReason": "filtered_empty",
    "errorMessage": "Your hashtag_list matched none of the 57 hashtags on the live US/7d board. Nothing was fabricated and nothing was charged."
  }
]

The accounting row carries every field of a hashtag row (shortened here); it is not charged.

---

How does it work?

As a TikTok Creative Center scraper, the actor reads the public trending-hashtag charts, the same ones any visitor can open without a TikTok account. It combines the overall chart with every industry chart for your country and window, removes repeats and keeps TikTok's own ranks. In the analytics result types it also reads each hashtag's public details and opens the hashtag's TikTok page in a real browser to collect its top videos, with rendering handled automatically. Blocked requests are retried through rotating residential proxies on their own. It returns only publicly visible data — what any visitor sees without logging in — and every row says which country and window TikTok actually served. The output fields stay the same from run to run, so your code and spreadsheets keep working when TikTok changes its pages.

---

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

It works with what you already use: the REST API from any language, MCP for AI agents, and no-code tools.

MCP integration for AI agents

Add the Apify MCP server to your AI client with one command:

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

This registers TikTok Trending Hashtags Analytics Scraper as a tool your agent can call directly: the agent finds it through the server's search, adds it and runs it, then reads the hashtag rows back as JSON. Ask for "this week's trending TikTok hashtags in Japan" and it does the rest. It works in Claude Code, Cursor and Windsurf.

No-code tools (n8n, Make, LangChain)

n8n: add the Apify node and choose "Run an Actor", or use the HTTP Request node pointed at the run-sync endpoint with your token. Send the TikTok trending hashtags export to a Google Sheet or Slack in the next node.

Make: use the Apify app's "Run an Actor" module, then "Get Dataset Items" to pull the hashtag rows into the rest of your scenario.

LangChain: install langchain-apify and wrap this actor with ApifyActorsTool() once it is in your account, so your agent can ask for trending hashtags by country.

---

Is it legal to scrape TikTok data?

Collecting publicly available trend data from TikTok is generally lawful, as long as you stay out of logged-in areas and private information. This actor returns only publicly available data — what any visitor sees without logging in. Hashtag charts are aggregate numbers, but the top creator handles and video links point to real people, so scraping public data is generally permissible, while storing and using it must comply with local data-protection law 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 Analytics Scraper return?

It returns each hashtag's rank, video views and posts in the window, industry, daily popularity curve and top creators, plus all-time totals, top videos and description in the analytics result types. See the data fields section for the full list.

Does TikTok Trending Hashtags Analytics 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 Analytics Scraper run?

A recorded ranking-only run returned 57 US hashtags in 2.6 seconds. With full analytics, a recorded run over the same 57 hashtags saved its first row after 11.5 seconds and finished in about 3.5 minutes, because each hashtag's top videos are read from its TikTok page. Every run reads live data, not a cache.

What happens if a hashtag is not on the board or has no data?

A hashtag from your list that is not on today's board is skipped with a note in the log, and nothing is invented for it. If none of them are on the board, the run saves one free accounting row with the reason. A hashtag whose top videos can't be loaded after three tries is still saved, with an empty top-video list, and the run summary counts it.

Can I scrape multiple TikTok hashtags at once?

Yes. One run returns the whole board for a country and window, about 55 hashtags. To scrape TikTok trending hashtags for several markets, start one run per country.

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

Yes — TikTok Trending Hashtags Analytics Scraper (Apify Actor ID: socialdataapi/tiktok-trending-hashtags-analytics-scraper, https://apify.com/socialdataapi/tiktok-trending-hashtags-analytics-scraper) is available as an MCP tool. Register it in Claude Code, Cursor or Windsurf with claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-trending-hashtags-analytics-scraper". Any agent that can call an HTTP endpoint can use the REST API directly.

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

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

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

The actor is maintained, and when TikTok changes, it is updated so your calls keep returning the same JSON fields with no changes on your end.

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

Yes. The browser for the top videos, retries and the switch to rotating residential proxies all run on the actor's side. You send one request and get structured JSON back, with no proxy accounts, no headless browser setup and no maintenance.

Which TikTok hashtag fields work best for AI training data and RAG indexing?

For RAG, use the text fields: hashtag name, description, industry name and top creator handles. For training data, use the numbers and flags: rank, video views and posts in the window, all-time totals, the daily popularity curve and the promoted flag. All fields are plain strings, numbers, booleans and lists, so no normalization is needed.

---

Your feedback

Found a bug or missing a field? Let us know in the actor's Issues tab. Every report is read, and fixes ship as new versions of the actor.