# Tiktok Trending Hashtags Analytics Scraper (`socialdataapi/tiktok-trending-hashtags-analytics-scraper`) Actor TikTok Trending Hashtags Analytics Scraper โ€” Analyze trending TikTok hashtags, including views, video counts, growth trends, related hashtags, and popularity metrics. Useful for trend research, content planning, hashtag strategy, influencer marketing, and competitor analysis. - **URL**: https://apify.com/socialdataapi/tiktok-trending-hashtags-analytics-scraper.md - **Developed by:** [Social Data API](https://apify.com/socialdataapi) (community) - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.09 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### 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. ![TikTok trending hashtags scraper output as JSON: rank, views, posts and industry](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-trending-hashtags-hero.webp) *** ### 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:** ```text 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. ```bash 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](https://console.apify.com/sign-up). 2. Open [TikTok Trending Hashtags Analytics Scraper](https://apify.com/socialdataapi/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](#mcp-integration-for-ai-agents) 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 ![Input fields of the TikTok Trending Hashtags Analytics Scraper](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-trending-hashtags-input.webp) 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 run`s and Apify's own test runs are never limited. #### Example input ```json { "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: ```json { "result_type": "analytics", "country": "US", "top100_period": "7", "hashtag_list": ["messi", "dell", "amazonprimeday"], "total_hashtags": 10, "proxyConfiguration": { "useApifyProxy": true } } ``` *** ### โฌ†๏ธ Output ![Output fields of the TikTok Trending Hashtags Analytics Scraper](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-trending-hashtags-output.webp) 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: ```json [ { "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: ```bash 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](#what-data-can-i-extract-with-tiktok-trending-hashtags-analytics-scraper) 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. # Actor input Schema ## `result_type` (type: `string`): top100 = board ranking only (analytics is an empty object). top100_with_analytics = ranking plus analytics: popularity curve, industry IDs, top creators and, under analytics.info, the hashtag's description, promoted flag, all-time posts and views and its top videos. analytics = the same analytics for every hashtag on the board, or only for the names in the custom hashtag list. ## `country` (type: `string`): TikTok publishes a trending board for 27 countries: 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. Every other value in this list, including ALL, is accepted and gets the US board; those rows say countrySupported=false and countryFallbackApplied=true. ## `top100_period` (type: `string`): TikTok serves three windows: 7, 30 and 90 days. 120 is kept for older inputs and gets the 90-day board; those rows say periodUsed=90 and periodAliasApplied=true. The popularity curve covers this window. ## `analytics_period` (type: `string`): Kept for older inputs only. The popularity curve always covers the board window above, so this value changes nothing. Every row reports analyticsPeriodRequested and analyticsPeriodSupported=false. ## `top100_industry` (type: `string`): Leave empty for the full board: the overall ranking plus every industry's top hashtags. Pick an industry to get only that industry's trending hashtags (TikTok shows about 3 per industry without a login). Real Estate has no TikTok ranking: it returns the full board and the rows say industryFilterSupported=false. ## `top100_new_on_board` (type: `boolean`): Kept for older inputs only. TikTok returns the same hashtags with and without this option and marks no hashtag as new on the board. Every row reports newOnBoardSupported=false. ## `hashtag_list` (type: `array`): Hashtag names without the # sign. Used only when the result type is analytics: only these hashtags are returned, if they are on the selected board today. Names that are not on the board are skipped with a warning and no row is invented for them. Leave empty to get the whole board. ## `total_hashtags` (type: `integer`): Maximum number of hashtag rows to save. The board holds about 55 hashtags per country and window (the overall ranking plus each industry's top hashtags), fewer when you pick an industry. Free plan: up to 20 hashtags per run and 200 per month; paid plans have no limit. ## `proxyConfiguration` (type: `object`): Apify Proxy (residential is used when no group is chosen) or your own proxy URLs. With the proxy turned off, Apify residential proxy is added automatically when your account has it. ## Actor input object example ```json { "result_type": "top100_with_analytics", "country": "US", "top100_period": "7", "analytics_period": "30", "top100_industry": "", "top100_new_on_board": false, "hashtag_list": [], "total_hashtags": 10, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): One row per hashtag on the requested board: rank, video views, posts, popularity curve summary, top creators and analytics. Also includes any uncharged accounting row (rowType=accounting) explaining why a run returned no hashtags. ## `coverage` (type: `string`): Same rows, showing what the run asked for versus what TikTok served: requested vs. used country and window, whether the industry filter was applied, which inputs have no effect (analytics period, new-on-board), and any error reason or message. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "hashtag_list": [], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("socialdataapi/tiktok-trending-hashtags-analytics-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "hashtag_list": [], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("socialdataapi/tiktok-trending-hashtags-analytics-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "hashtag_list": [], "proxyConfiguration": { "useApifyProxy": true } }' | apify call socialdataapi/tiktok-trending-hashtags-analytics-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,socialdataapi/tiktok-trending-hashtags-analytics-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/Z5ZJfvBFBwIyy5eAI/builds/FZjK7XfT31xte4NLw/openapi.json