# TikTok Trending Hashtags Scraper (`khadinakbar/tiktok-trending-hashtags-scraper`) Actor Extract top 100 trending TikTok hashtags with rank changes, views, post counts & daily sparklines. Filter by 60+ countries & 18 industries. Human-readable output. No login needed. - **URL**: https://apify.com/khadinakbar/tiktok-trending-hashtags-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Social media, Automation, MCP servers - **Stats:** 11 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 trending hashtag extracteds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## πŸ”₯ TikTok Trending Hashtags Scraper ### What does TikTok Trending Hashtags Scraper do? This actor extracts the top trending TikTok hashtags directly from TikTok Creative Center β€” the same dashboard professional marketers use to plan campaigns. For each hashtag you get its rank, rank change, total video views, post count, a promoted flag, and a daily sparkline showing how its popularity has moved over the period. **No login, no cookies, no TikTok account required.** It runs on publicly available data from `ads.tiktok.com/business/creativecenter`. ### Why use TikTok Trending Hashtags Scraper? - **Find trends before they peak.** The `is_new_to_top100` filter surfaces hashtags making their first appearance in the top 100 β€” your early-mover advantage. - **Track momentum, not just rank.** The `rank_diff` field shows exactly how many positions a hashtag has moved vs the prior period β€” `+5` means it jumped 5 spots. Know if a trend is accelerating before your competitors do. - **Spot sponsored hashtags.** The `is_promoted` field flags TikTok's paid promotional hashtags β€” keep your organic research clean or study what brands are paying to push. - **60+ country filters.** Pull trending data for the US, UK, India, Brazil, Japan, or any of 60+ markets β€” not just global averages. - **18 industry categories.** Filter by Beauty, Gaming, Fashion, Food, Health, Travel, and more β€” so you see what's trending in *your* niche. - **Human-readable output.** Unlike competitors that return raw numeric IDs (like `23000000000` for Gaming), this actor returns clean names like `"Gaming"`, `"Beauty & Personal Care"`, `"Fashion & Apparel"`. - **40% cheaper than alternatives.** At $0.003/hashtag vs $0.005 from the nearest hashtag-only competitor. ### What data does TikTok Trending Hashtags Scraper extract? | Field | Type | Description | |-------|------|-------------| | `rank` | number | Position in TikTok's trending list (1 = hottest) | | `rank_diff` | number\|null | Rank change vs prior period (positive = gained positions) | | `rank_diff_type` | string\|null | Direction of change: `"up"`, `"down"`, `"new"`, or `"stable"` | | `hashtag_name` | string | Hashtag text without `#` (e.g. `fyp`, `viral`) | | `hashtag_id` | string | TikTok's internal hashtag ID (stable across runs) | | `post_count` | number | Total videos tagged with this hashtag | | `video_views` | number | Aggregate views across all tagged videos | | `is_new_to_top100` | boolean | Whether this is a fresh entrant to the top 100 | | `is_promoted` | boolean | Whether TikTok has marked this as a promoted/sponsored hashtag | | `country_code` | string | Country filter used (or `GLOBAL`) | | `industry_name` | string | Human-readable industry name | | `time_period_days` | number | Trending window: 7, 30, or 120 days | | `sparkline_data` | array | Daily time-series β€” each point has `time` (YYYY-MM-DD) and `value` (0–1 normalized score) | | `scraped_at` | string | ISO 8601 timestamp of extraction | | `source_url` | string | Creative Center URL with all filters applied | ### How to scrape TikTok trending hashtags #### Step 1 β€” Configure your run Set these inputs in the actor UI or via the API: | Input | Description | Example | |-------|-------------|---------| | `timePeriod` | `"7"`, `"30"`, or `"120"` days | `"7"` | | `country` | ISO country code or leave blank for global | `"US"` | | `industry` | Industry filter or `"All Industries"` | `"Beauty & Personal Care"` | | `maxResults` | How many hashtags to return (1–100) | `100` | | `isNewToTop100` | Only show new entrants? | `false` | #### Step 2 β€” Click Start The actor navigates to TikTok Creative Center, intercepts the API response, and extracts the trending data. A full 100-hashtag run typically takes 20–40 seconds. #### Step 3 β€” Download your data Export as JSON, CSV, or Excel from the Dataset tab. Or pipe results directly into your workflow via the Apify API. ### Sample output ```json { "rank": 3, "rank_diff": 2, "rank_diff_type": null, "hashtag_name": "beautytok", "hashtag_id": "16442", "post_count": 108171, "video_views": 595340071, "is_new_to_top100": false, "is_promoted": false, "country_code": "US", "industry_name": "Beauty & Personal Care", "time_period_days": 7, "sparkline_data": [ { "time": "2026-04-01", "value": 1.0 }, { "time": "2026-04-02", "value": 0.90 }, { "time": "2026-04-03", "value": 0.88 }, { "time": "2026-04-07", "value": 0.81 } ], "scraped_at": "2026-04-08T10:30:00.000Z", "source_url": "https://ads.tiktok.com/business/creativecenter/trending/hashtag?period=7®ion=US&lang=en" } ```` ### Pricing This actor uses **pay-per-event pricing** at **$0.003 per hashtag extracted**. | Run | Hashtags | Cost | |-----|----------|------| | Quick snapshot | 10 | ~$0.03 | | Standard run | 50 | ~$0.15 | | Full top 100 | 100 | ~$0.30 | | Daily monitoring (30 days) | 100/day | ~$9.00/mo | You are only charged for successfully extracted hashtags. If the actor returns 0 results due to a platform change, you are not charged. ### Use cases #### πŸ“± Content Creator Strategy Find which hashtags are peaking *right now* in your niche before posting. Use the `isNewToTop100` filter to spot trends at the inflection point β€” before everyone piles in. Use `rank_diff` to know whether a trend is still accelerating or has already peaked. #### πŸ“Š Social Media Marketing Pull weekly trending data for your industry and country. Build a hashtag bank for campaigns. Monitor when your campaign hashtag starts to trend. The `is_promoted` flag helps you separate organic trends from paid pushes. #### πŸ”¬ Market Research & Social Listening Track which topics are gaining traction in specific regions. Identify emerging conversations by monitoring `is_new_to_top100` entries over time. Run across multiple countries to spot trends going global. #### πŸ† Competitor Analysis See what hashtags your competitors' target audiences are engaging with. Cross-reference with your own content strategy to find gaps. Use industry filters to narrow to your exact niche. #### πŸ€– AI & Automation Pipelines Pipe trending hashtag data into content generation workflows, social scheduling tools, or reporting dashboards via the Apify API. The clean, consistent JSON output integrates directly with n8n, Make, Zapier, and AI agents. ### Running via API ```javascript import ApifyClient from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('khadinakbar/tiktok-trending-hashtags-scraper').call({ timePeriod: '7', country: 'US', industry: 'Beauty & Personal Care', maxResults: 100, isNewToTop100: false, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); // [{ rank: 1, hashtag_name: 'beautytok', rank_diff: 2, video_views: 595000000, ... }, ...] ``` ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("khadinakbar/tiktok-trending-hashtags-scraper").call(run_input={ "timePeriod": "7", "country": "US", "industry": "Beauty & Personal Care", "maxResults": 100, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["hashtag_name"], item["video_views"], item["rank_diff"]) ``` ### Scheduling You can schedule this actor to run automatically: 1. Click **Schedule** in the Apify Console 2. Set your cron (e.g. `0 9 * * 1` for every Monday at 9am) 3. Connect the output dataset to your CRM, spreadsheet, or Slack via Zapier/Make This gives you a weekly trending hashtag report with zero manual effort. ### Works great with - **TikTok Hashtag Scraper** β€” once you have trending hashtags, scrape the actual videos using those hashtags to find the best content formats - **TikTok Profile Scraper** β€” pass trending hashtags into a profile or video scraper to find top creators in that niche - **Google Sheets Integration** β€” export directly to a spreadsheet for weekly trend reports with sparkline charts ### FAQ **Q: Do I need a TikTok account or API key?** No. This actor scrapes publicly available data from TikTok Creative Center. No login, no cookies, no API credentials required. **Q: How fresh is the data?** The actor pulls live data from TikTok Creative Center each time it runs. There is no caching β€” every run returns the current trending state. **Q: Can I get more than 100 hashtags?** TikTok Creative Center surfaces a maximum of 100 hashtags per query. To get broader coverage, run multiple queries with different country or industry filters. **Q: What does `rank_diff` mean exactly?** It shows how many positions a hashtag moved vs the previous period. A `rank_diff` of `3` means the hashtag moved up 3 spots (from rank 7 to rank 4, for example). This is one of the most valuable signals for spotting accelerating trends. **Q: What does `is_promoted` mean?** When `true`, TikTok's Creative Center has flagged this hashtag as promoted or sponsored β€” meaning a brand is paying to push it. When `false`, the trend is organic. **Q: What if the actor returns 0 results?** TikTok occasionally updates their Creative Center SPA. If this happens, please open an issue and we'll push a fix within 48 hours. **Q: Can I filter by both country AND industry?** Yes β€” both filters can be applied simultaneously. Set `country: "US"` and `industry: "Gaming"` to get the top gaming hashtags in the United States. **Q: Is this legal / compliant?** Yes. TikTok Creative Center is a public-facing tool designed for advertisers and creators. All data extracted is publicly available without authentication. ### Legal disclaimer *This actor is designed for lawful data collection from publicly available sources. Users are responsible for compliance with applicable laws, TikTok's terms of service, and relevant data protection regulations (GDPR, CCPA, etc.). Extracted data should not be used for unauthorized commercial purposes, spam, or harassment.* *** Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools. # Actor input Schema ## `timePeriod` (type: `string`): Trending window. Use '7' for past 7 days (hottest right now), '30' for monthly trends, '120' for 4-month view. Use this when the user says 'this week', 'last 7 days', 'monthly', or 'long-term'. Default is 7 days. ## `country` (type: `string`): Filter trending hashtags by country. Use country codes like 'US', 'GB', 'IN', 'BR'. Leave empty for global trends. Use this when the user mentions a specific country or region. ## `industry` (type: `string`): Filter by industry vertical. Use this when the user mentions a niche like 'beauty', 'gaming', 'fashion', or 'fitness'. Leave as 'All Industries' for cross-niche trending data. ## `maxResults` (type: `integer`): Maximum number of trending hashtags to return (1–100). TikTok Creative Center surfaces up to 100 per query. Use 10–20 for quick snapshots, 100 for full trend reports. ## `isNewToTop100` (type: `boolean`): When enabled, only returns hashtags that are new entrants to the top 100 this period β€” great for spotting emerging trends before they peak. ## `proxyConfiguration` (type: `object`): Proxy settings for bypassing TikTok rate limits. Recommended for frequent runs or if you see empty results. Use Apify Residential proxies for best reliability. ## Actor input object example ```json { "timePeriod": "7", "country": "", "industry": "All Industries", "maxResults": 100, "isNewToTop100": false } ``` # Actor output Schema ## `trendingHashtags` (type: `string`): Dataset of trending TikTok hashtag records extracted from Creative Center. Each item: rank, rank\_diff, rank\_diff\_type, hashtag\_name, hashtag\_id, post\_count, video\_views, is\_new\_to\_top100, is\_promoted, country\_code, industry\_name, time\_period\_days, sparkline\_data, scraped\_at, source\_url. # 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 = { "timePeriod": "7", "country": "", "industry": "All Industries", "maxResults": 100, "isNewToTop100": false }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/tiktok-trending-hashtags-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 = { "timePeriod": "7", "country": "", "industry": "All Industries", "maxResults": 100, "isNewToTop100": False, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/tiktok-trending-hashtags-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "timePeriod": "7", "country": "", "industry": "All Industries", "maxResults": 100, "isNewToTop100": false }' | apify call khadinakbar/tiktok-trending-hashtags-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/tiktok-trending-hashtags-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Trending Hashtags Scraper", "description": "Extract top 100 trending TikTok hashtags with rank changes, views, post counts & daily sparklines. Filter by 60+ countries & 18 industries. Human-readable output. No login needed.", "version": "1.0", "x-build-id": "YEk8fxEGiwhQw9mDw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~tiktok-trending-hashtags-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-tiktok-trending-hashtags-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~tiktok-trending-hashtags-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-tiktok-trending-hashtags-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~tiktok-trending-hashtags-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-tiktok-trending-hashtags-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "timePeriod": { "title": "Time Period", "enum": [ "7", "30", "120" ], "type": "string", "description": "Trending window. Use '7' for past 7 days (hottest right now), '30' for monthly trends, '120' for 4-month view. Use this when the user says 'this week', 'last 7 days', 'monthly', or 'long-term'. Default is 7 days.", "default": "7" }, "country": { "title": "Country", "enum": [ "", "US", "GB", "IN", "BR", "MX", "ID", "JP", "KR", "DE", "FR", "TR", "RU", "ES", "IT", "CA", "AU", "AR", "CO", "TH", "VN", "NL", "PL", "SA", "AE", "SG", "PH", "MY", "NG", "ZA", "CL", "PE", "TW", "PK", "BD", "EG", "AT", "BE", "BG", "BY", "CZ", "DK", "FI", "GR", "HU", "IE", "IL", "IQ", "IS", "KH", "KW", "LB", "LT", "LV", "MA", "MM", "NO", "NZ", "OM", "PT", "QA", "RO", "SK", "SE", "CH", "UA", "UZ" ], "type": "string", "description": "Filter trending hashtags by country. Use country codes like 'US', 'GB', 'IN', 'BR'. Leave empty for global trends. Use this when the user mentions a specific country or region.", "default": "" }, "industry": { "title": "Industry / Niche", "enum": [ "All Industries", "Gaming", "E-commerce & Shopping", "Beauty & Personal Care", "Food & Beverage", "Health & Fitness", "Entertainment", "Sports & Outdoors", "Finance", "Education", "Travel", "Business Services", "Fashion & Apparel", "Technology", "Home & DΓ©cor", "Parenting & Kids", "Media & Entertainment", "News & Information", "Music" ], "type": "string", "description": "Filter by industry vertical. Use this when the user mentions a niche like 'beauty', 'gaming', 'fashion', or 'fitness'. Leave as 'All Industries' for cross-niche trending data.", "default": "All Industries" }, "maxResults": { "title": "Max Hashtags", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of trending hashtags to return (1–100). TikTok Creative Center surfaces up to 100 per query. Use 10–20 for quick snapshots, 100 for full trend reports.", "default": 100 }, "isNewToTop100": { "title": "New to Top 100 Only", "type": "boolean", "description": "When enabled, only returns hashtags that are new entrants to the top 100 this period β€” great for spotting emerging trends before they peak.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for bypassing TikTok rate limits. Recommended for frequent runs or if you see empty results. Use Apify Residential proxies for best reliability." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```