# TikTok Hashtag Scraper Pro (`badruddeen/tiktok-hashtag-scraper-pro`) Actor A TikTok discovery and analytics engine that maps viral content, creators, and trends. It crawls search and hashtag feeds, builds engagement insights, and generates interactive reports to reveal what’s driving attention across the platform. - **URL**: https://apify.com/badruddeen/tiktok-hashtag-scraper-pro.md - **Developed by:** [Badruddeen Naseem](https://apify.com/badruddeen) (community) - **Categories:** Social media, Videos, Developer tools - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $13.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Hashtag Scraper Pro ### What does TikTok Hashtag Scraper Pro do? TikTok Hashtag Scraper Pro enables you to extract comprehensive data from TikTok with greater depth and flexibility than the official TikTok API. This discovery and analytics engine maps viral content, creators, and trends across the platform. TikTok Hashtag Scraper Pro can scrape: - Hashtag feed data and trending hashtags - Video metadata (views, likes, comments, shares) - Creator profiles and engagement metrics - Content trends and viral patterns - Interactive analytics and reports ### Why scrape TikTok? TikTok has over 1 billion monthly active users and is one of the most influential platforms for discovering trends, content, and emerging creators. It's a rich source of data for market research, content strategy, and competitive analysis. Here are just some of the ways you could use TikTok data: - Monitor trending topics and viral content in real-time - Track creator performance and audience engagement patterns - Analyze hashtag performance and content discoverability - Identify emerging trends before they reach mainstream media - Conduct competitive analysis and benchmark content strategies - Build datasets for machine learning and AI training If you would like more inspiration on how scraping TikTok could help your business or organization, check out our [industry pages](https://apify.com/industries). ### How to scrape TikTok It's easy to scrape TikTok with TikTok Hashtag Scraper Pro. Just follow these few steps and you'll get your data in a few minutes. 1. Click on **Try for free**. 2. Enter the hashtags, keywords, or creator usernames you want to analyze. 3. Configure your scraping parameters (date range, content filters, etc.). 4. Click on **Run**. 5. When TikTok Hashtag Scraper Pro has finished, preview or download your data from the **Dataset** tab. ### How much will it cost to scrape TikTok? Apify gives you $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). You can scrape thousands of TikTok posts per month with those credits, so many results will be completely free! If you need to get more data regularly from TikTok, we recommend our [$49/month Starter plan](https://apify.com/pricing). This plan allows you to scrape significantly more content and build comprehensive trend reports. For large-scale data collection and enterprise needs, the [Scale plan](https://apify.com/pricing) at $499/month provides unlimited API calls and priority support. ### Results TikTok Hashtag Scraper Pro returns structured JSON data including: ```json { "videoId": "7234567890123456789", "hashtags": ["#trending", "#viral"], "videoUrl": "https://www.tiktok.com/@username/video/...", "description": "Video description text", "stats": { "likes": 250000, "comments": 15000, "shares": 8500, "views": 2500000 }, "creator": { "username": "creator_handle", "followerCount": 500000, "verified": true }, "uploadDate": "2024-01-15T10:30:00Z", "musicTitle": "Song name", "musicArtist": "Artist name" } ```` ### Tips for scraping TikTok - Use specific hashtags to narrow your results and reduce API costs - Schedule regular scraping runs to monitor trend evolution over time - Combine multiple hashtags to identify content overlap and cross-platform trends - Filter results by engagement metrics to focus on high-performing content - Export data in multiple formats for integration with analytics tools - Set appropriate delays between requests to ensure reliable data collection ### Is it legal to scrape TikTok? Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) # Actor input Schema ## `safeMode` (type: `boolean`): If enabled, the actor will NOT scrape TikTok. It will generate dummy dataset items for testing Apify runs. ## `query` (type: `string`): Comma-separated terms or hashtags (without #). Example: dance,viral dance ## `maxScrollSearch` (type: `integer`): 0 = auto scroll until no new content ## Actor input object example ```json { "safeMode": false, "query": "vaavu thinadhoo", "maxScrollSearch": 1 } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `insightReport` (type: `string`): No description ## `allFields` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("badruddeen/tiktok-hashtag-scraper-pro").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 = {} # Run the Actor and wait for it to finish run = client.actor("badruddeen/tiktok-hashtag-scraper-pro").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 '{}' | apify call badruddeen/tiktok-hashtag-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=badruddeen/tiktok-hashtag-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Hashtag Scraper Pro", "description": "A TikTok discovery and analytics engine that maps viral content, creators, and trends. It crawls search and hashtag feeds, builds engagement insights, and generates interactive reports to reveal what’s driving attention across the platform.", "version": "0.0", "x-build-id": "6Qc8LOYPnkL24onRa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/badruddeen~tiktok-hashtag-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-badruddeen-tiktok-hashtag-scraper-pro", "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/badruddeen~tiktok-hashtag-scraper-pro/runs": { "post": { "operationId": "runs-sync-badruddeen-tiktok-hashtag-scraper-pro", "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/badruddeen~tiktok-hashtag-scraper-pro/run-sync": { "post": { "operationId": "run-sync-badruddeen-tiktok-hashtag-scraper-pro", "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", "required": [ "query" ], "properties": { "safeMode": { "title": "Safe Mode (Testing Only)", "type": "boolean", "description": "If enabled, the actor will NOT scrape TikTok. It will generate dummy dataset items for testing Apify runs.", "default": false }, "query": { "title": "Search Terms / Hashtags", "type": "string", "description": "Comma-separated terms or hashtags (without #). Example: dance,viral dance", "default": "vaavu thinadhoo" }, "maxScrollSearch": { "title": "Maximum Scroll Count", "minimum": 0, "maximum": 20, "type": "integer", "description": "0 = auto scroll until no new content", "default": 1 } } }, "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 } } } } } } } } } } ```