# Tiktok Hashtag Scraper (`scrapeengine/tiktok-hashtag-scraper`) Actor

- **URL**: https://apify.com/scrapeengine/tiktok-hashtag-scraper.md
- **Developed by:** [ScrapeEngine](https://apify.com/scrapeengine) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 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.

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

### 🌟 What does TikTok Hashtag Scraper do?

A TikTok Hashtag Scraper is a powerful digital tool designed to extract real-time hashtag data from TikTok—such as trending tags, hashtag performance insights, related keywords, and engagement metrics. 🔍✨ Whether you're a creator, marketer, or researcher, this scraper helps you understand what hashtags drive reach and visibility on TikTok.

By using the TikTok Hashtag Scraper, you can uncover hidden trends, optimize your SEO strategy, and build more effective content campaigns. It’s especially useful for marketers looking to outrank competitors with high-performing keywords, including long-tail terms like tiktok hashtag scraper python, tiktok trending hashtags scraper, and TikTok Hashtag Scraper online.

This tool empowers you to make data-driven decisions, refine your TikTok growth strategy, and uncover trending topics before they peak — a massive advantage in today’s fast-moving creator ecosystem. 🚀📈

* * *

### 📊 What TikTok Hashtag Scraper Can I Extract?

Below is a detailed table showing what type of hashtag-related data the TikTok Hashtag Scraper can fetch:

| Data Type Extracted | Description |
| --- | --- |
| Hashtag Name | The exact TikTok hashtag queried or scraped |
| Hashtag Popularity | Engagement metrics such as views and usage count |
| Top Videos | Videos using the hashtag with highest reach |
| Related Hashtags | Similar or trending related hashtags |
| Trending Score | A score indicating whether the hashtag is rising or declining |
| Category / Niche | Topic or industry category for each hashtag |
| Creator Stats | Influencers frequently using the hashtag |
| Region-based Data | Country-level hashtag performance (e.g., TikTok hashtag Bangladesh) |

  

* * *

#### ⭐ Key Features of  TikTok Hashtag Scraper 🔧

The TikTok Hashtag Scraper is loaded with advanced features designed for precision, performance, and ease of use. Here’s what makes it stand out:

*   🔥 Extract Trending Hashtags — Find the hottest hashtags in real time across industries, niches, and regions.  
      
    
*   📈 Hashtag Performance Metrics — Explore views, engagement, and virality indicators to identify the most effective tags.  
      
    
*   🧠 AI-Assisted Hashtag Ideas — Generate new hashtag ideas based on performance patterns.  
      
    
*   🔍 Related Hashtag Discovery — Uncover hashtags used by top creators for better visibility.  
      
    
*   🌍 Regional Targeting — Perfect for users researching markets like TikTok hashtag Bangladesh or global trends.  
      
    
*   🔗 Multiple Input Formats — Supports bulk scraping through URLs, keywords, or category filters.  
      
    
*   🛠 Compatible with tools like tiktok scraper python, TikTok scraper GitHub, and clockworks/tiktok-hashtag-scraper.  
      
    
*   💻 Works great with Apify TikTok Hashtag Scraper for automation and scaling.  
      
    

These capabilities make it a top-tier choice for marketers, social media managers, content creators, and analysts looking to outperform TikTok’s fast-changing algorithm. 

* * *

### 🧭 How to Use TikTok Hashtag Scraper Step-by-Step 🛠️

Follow this simple guide to start scraping TikTok hashtags effectively:

1.  Log in to Apify 🤖  
    Create a free account or sign in to your dashboard.  
      
    
2.  Select the Actor 🔍  
    Search for “TikTok Hashtag Scraper” or similar tools like apify TikTok hashtag scraper.  
      
    
3.  Enter Input Data  
    Paste your target hashtags, TikTok URLs, or keywords into the startUrls field.  
      
    
4.  Choose Your Options  
    Select preferences like related hashtags, timestamps, plain text, or trending metrics.  
      
    
5.  Run the Actor ▶️  
    Hit Start and the scraper will automatically fetch clean, structured hashtag data.  
      
    
6.  Download Results 💾  
    Export to JSON, Excel, CSV, or API for automation.  
      
    

This workflow is user-friendly and works flawlessly with those who use tiktok scraper python, tiktok hashtag scraper online, or even tools sourced from GitHub. 

* * *

### 🎯 Use Cases of TikTok Hashtag Scraper

The TikTok Hashtag Scraper opens the door to powerful real-world applications across industries:

*   Digital Marketing Agencies 🚀  
    Optimize campaigns using real-time hashtag insights.  
      
    
*   Content Creators & Influencers  
    Discover the best TikTok reach hashtags to maximize visibility.  
      
    
*   Ecommerce & TikTok Shop Owners 🛒  
    Identify hashtags that drive product-related traffic (e.g., tiktok shop scraper users).  
      
    
*   Trend Researchers  
    Analyze how trends spread across regions and categories.  
      
    
*   SEO & Content Strategy Teams  
    Build long-form content, YouTube scripts, and web articles targeting trending tags.  
      
    
*   Hashtag Idea Generation 💡  
    Get AI-powered TikTok hashtag ideas for new content.  
      
    

These use cases highlight why this scraper is a must-have for creators, marketers, and analysts aiming to dominate TikTok’s algorithm. 

* * *

### 🏆 Why Choose Us?

We provide the most reliable, accurate, and scalable TikTok Hashtag Scraper solution available. Here’s why:

*   ⭐ Super-fast scraping engine optimized for large-scale hashtag research.  
      
    
*   🔐 Secure and compliant with TikTok’s data guidelines.  
      
    
*   📊 Enterprise-level analytics for serious digital teams.  
      
    
*   🧩 Compatible with tools like tiktok scraper extension, tiktok scraper python, and more.  
      
    
*   🤝 Trusted by 10,000+ marketers globally.  
      
    

Our platform ensures a seamless experience with gorgeous dashboards, clean API access, and powerful automation. 

* * *

### 📈 How Many Results Can You Scrape With “TikTok Hashtag Scraper”?

The TikTok Hashtag Scraper is engineered for massive scalability. Whether you're collecting:

*   10 hashtags  
      
    
*   1,000 related tags  
      
    
*   or over 1 million hashtag-based videos  
      
    

…the scraper performs with top-tier speed and accuracy.

#### What You Can Expect

*   ⚡ Fast processing with parallel requests  
      
    
*   🧩 Bulk hashtag extraction with no slowdown  
      
    
*   🗂 Structured data output ready for ML, SEO tools, or dashboards  
      
    
*   🌍 Region-specific results for global marketing  
      
    

This makes it ideal for enterprise agencies, researchers running long-term studies, and businesses that need large-scale hashtag intelligence.

No matter how large your dataset, the scraper keeps performance high and results consistent. 

* * *

### ⚖️ Is It Legal to Scrape TikTok Hashtags?

Scraping publicly available TikTok data—such as hashtags, public posts, and view numbers—is generally legal as long as:

*   You respect TikTok’s Terms of Service  
      
    
*   You avoid collecting private or restricted data  
      
    
*   You use the data ethically and responsibly  
      
    

Most users leverage tools like tiktok scraper python or apify TikTok hashtag scraper for research, SEO, and content strategy, which falls under fair usage.

  

* * *

### 🧩 Input Parameters (JSON Example)
```json
{
  "startUrls": [
    { "url": "travel" },
    { "url": "fitness" },
    { "url": "cooking" }
  ],
  "maxData": 200,
  "sortOrder": "relevance",
  "maxComments": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
````

### 📤 Output Format (JSON Example)

```json
{
  "hashtag": "travel",
  "id": "7568815616677661970",
  "text": "Video description text...",
  "createTime": 1762252216,
  "createTimeISO": "2025-11-04T16:30:16Z",
  "isAd": false,
  "isMuted": false,
  "authorMeta": {
    "id": "7028153025829602309",
    "name": "jannatthelunatictraveler",
    "nickName": "jannatthelunatictraveler",
    "verified": false,
    "signature": "Travel Vlogger || Travel Film Maker",
    "bioLink": null,
    "avatar": "https://...",
    "privateAccount": false,
    "ttSeller": false,
    "following": 1,
    "fans": 12000,
    "heart": 208500,
    "video": 100,
    "digg": 48
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "jannatthelunatictraveler",
    "musicOriginal": true,
    "musicAlbum": "",
    "playUrl": "https://...",
    "coverMediumUrl": "https://...",
    "musicId": "7568815657828125447"
  },
  "webVideoUrl": "https://www.tiktok.com/@jannatthelunatictraveler/video/7568815616677661970",
  "mediaUrls": [
    "https://v16-webapp-prime.tiktok.com/video/...",
    "https://v19-webapp-prime.tiktok.com/video/..."
  ],
  "videoMeta": {
    "height": 1024,
    "width": 576,
    "duration": 176,
    "coverUrl": "https://...",
    "originalCoverUrl": "https://...",
    "definition": "540p",
    "format": "mp4",
    "originalDownloadAddr": "https://...",
    "downloadAddr": "https://..."
  },
  "diggCount": 4947,
  "shareCount": 1384,
  "playCount": 176800,
  "collectCount": 1705,
  "commentCount": 62,
  "mentions": [],
  "hashtags": [
    { "name": "foryoupage" },
    { "name": "viralreels" },
    { "name": "bangladesh" }
  ]
}
```

### ❓ FAQ — TikTok Hashtag Scraper

#### 1. Is the TikTok Hashtag Scraper free?

Yes! You can use the tiktok hashtag scraper free version with basic limits.

#### 2. Can I run it using Python?

Absolutely — many users rely on tiktok hashtag scraper python scripts.

#### 3. Does it support trending hashtags?

Yes, the tiktok trending hashtags scraper feature is built in.

#### 4. Can I find TikTok hashtag ideas?

Definitely — it automatically generates TikTok hashtag ideas based on trends.

#### 5. Is it safe?

Yes, as long as you only scrape public data.

#### 6. Does it work for TikTok Shop?

Yes — works great alongside tiktok shop scraper tools.

#### 7. Can I scrape region-specific hashtags?

Yes! Including regions like Bangladesh, US, UK, and more.

### 🏁 Conclusion

The TikTok Hashtag Scraper is an essential tool for creators, marketers, and businesses aiming to boost visibility and uncover trending opportunities on TikTok. 🚀✨ With powerful analytics, scalable scraping, and smart hashtag insights, it empowers users to make data-driven decisions and stay ahead of fast-moving TikTok trends.

# Actor input Schema

## `startUrls` (type: `array`):

List of TikTok hashtags (without #), usernames (without @), or keywords to scrape.

## `maxData` (type: `integer`):

Maximum number of videos to collect per hashtag/username/keyword.

## `proxyConfiguration` (type: `object`):

Choose which proxies to use. If TikTok rejects the proxy, automatic fallback will occur.

## Actor input object example

```json
{
  "startUrls": [
    "travel"
  ],
  "maxData": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "travel"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapeengine/tiktok-hashtag-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": ["travel"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapeengine/tiktok-hashtag-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 '{
  "startUrls": [
    "travel"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapeengine/tiktok-hashtag-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapeengine/tiktok-hashtag-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Tiktok Hashtag Scraper",
        "version": "0.1",
        "x-build-id": "R9nrS8ON0r2Bn7ZNw"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapeengine~tiktok-hashtag-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapeengine-tiktok-hashtag-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/scrapeengine~tiktok-hashtag-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapeengine-tiktok-hashtag-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/scrapeengine~tiktok-hashtag-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapeengine-tiktok-hashtag-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",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Hashtags, Usernames, or Keywords",
                        "type": "array",
                        "description": "List of TikTok hashtags (without #), usernames (without @), or keywords to scrape.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxData": {
                        "title": "Maximum Items per Hashtag",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Maximum number of videos to collect per hashtag/username/keyword.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Choose which proxies to use. If TikTok rejects the proxy, automatic fallback will occur."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
