# TikTok Hashtag Analytics & Trends Scraper (`scrapers_lat/tiktok-hashtag-analytics-scraper`) Actor
Scrape TikTok hashtag analytics from the public Creative Center: video views, post counts, week-over-week growth, related trending hashtags and top videos. Discover trending hashtags automatically or analyze your own list. Export JSON, CSV, Excel.
- **URL**: https://apify.com/scrapers\_lat/tiktok-hashtag-analytics-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.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
[](https://console.apify.com/actors/HwrMFNahFNVZASh2I/input)
## TikTok Hashtag Analytics & Trends Scraper
> Pull TikTok hashtag analytics from the public Creative Center: video views, post counts, week-over-week growth, related trending hashtags and top videos, with no login or API key
Views + growth per hashtag
Trend discovery related hashtag graph
JSON / CSV / Excel output formats
### What you get
Each record is one TikTok hashtag with the analytics that TikTok publishes on its Creative Center trend pages. Give the actor a list of hashtags to analyze, or leave it empty and let it discover trending hashtags by following the related hashtag graph.
- **imageUrl**: cover image of the hashtag's top video
- **hashtagName**: the hashtag, without the leading #
- **url**: link to the hashtag page inside TikTok Creative Center
- **videoViews**: total views across videos using the hashtag
- **videoViewsWow**: week-over-week change in views as a rate (0.5 means +50 percent, -0.4 means -40 percent)
- **postCount**: number of videos published with the hashtag
- **postCountWow**: week-over-week change in post count as a rate
- **region**: market and language context selected for the run
- **relatedHashtags\***: list of related trending hashtags, each with its own view count
- **topVideos\***: top videos for the hashtag, each with title, url, views, likes, comments, shares, author and cover
- **observedAt**: when the hashtag was last seen by the scraper
*\*These fields appear when Include related hashtags and top videos is on (the default).*
### How it works
TikTok publishes hashtag trend data on its public Creative Center pages. This actor reads that public data directly over HTTP, with no login and no API key.
- **Analyze your own hashtags**: add hashtags to the Hashtags field (with or without #). The actor returns analytics for every one that TikTok tracks in its public trend index.
- **Discover trending hashtags**: leave the Hashtags field empty. The actor starts from a set of trending hashtags and follows the related hashtag graph, collecting new trending hashtags until it reaches your Max Items.
Only hashtags that TikTok includes in its public trend index return data, so very generic tags may not resolve. The related hashtag graph is the reliable way to surface what is trending right now.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Trending TikTok Hashtags (US)](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/trending-hashtags-us): Discover trending TikTok hashtags in the US with post counts, view counts, related hashtags and top videos for content and marketing research.
- [Trending TikTok Hashtags (UK)](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/trending-hashtags-uk): Discover trending TikTok hashtags for the UK market with post counts, view counts, related hashtags and top videos for creators and brands.
- [NBA Basketball TikTok Hashtags (US)](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/nba-basketball-hashtags-us): Analyze NBA and basketball TikTok hashtags with post counts, views, related trending tags and top videos for sports marketing and content research.
- [NFL Football TikTok Hashtags (US)](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/nfl-football-hashtags-us): Analyze NFL and American football TikTok hashtags with post counts, views, related trending tags and top videos for sports content strategy.
- [Soccer TikTok Hashtags (UK)](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/soccer-football-hashtags-uk): Analyze soccer and football TikTok hashtags for the UK with post counts, views, related trending tags and top videos for sports marketing.
- [UFC Combat Sports TikTok Hashtags](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/ufc-combat-sports-hashtags-us): Analyze UFC and combat sports TikTok hashtags with post counts, views, related trending tags and top videos for sports content and marketing.
- [Fortnite Gaming TikTok Hashtags](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/fortnite-gaming-hashtags-us): Analyze Fortnite and gaming TikTok hashtags with post counts, views, related trending tags and top videos for gaming content and creator research.
- [Mobile Gaming TikTok Hashtags](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/mobile-gaming-hashtags-us): Analyze mobile gaming TikTok hashtags like Mobile Legends with post counts, views, related trending tags and top videos for gaming marketing.
- [K-Pop Music TikTok Hashtags](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/kpop-music-hashtags-us): Analyze K-pop and music TikTok hashtags with post counts, views, related trending tags and top videos for music promotion and fan research.
- [Travel Paris TikTok Hashtags](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples/travel-paris-hashtags): Analyze travel TikTok hashtags around Paris with post counts, views, related trending destinations and top videos for travel content and marketing.
### Who is it for
| Use case | Who benefits |
|---|---|
| Finding trending hashtags before publishing | Social media managers and creators |
| Measuring hashtag momentum with week-over-week growth | Growth and performance marketers |
| Building hashtag sets for a campaign | Agencies and content strategists |
| Sourcing top-performing reference videos per hashtag | Creative strategists |
| Tracking which hashtags are rising or fading | Brand and trend analysts |
### Input
| Field | Type | Description |
|---|---|---|
| Max Items | integer | Maximum number of hashtags to collect. |
| Include related hashtags and top videos | boolean | Add related hashtags and top videos to each record. On by default. |
| Hashtags | list | Specific hashtags to analyze. Leave empty to discover trending hashtags. |
| Discover related trending hashtags | boolean | Follow the related hashtag graph to find more trending hashtags. On by default. |
| Region | select | Market and language context for the hashtag pages. |
| Proxy configuration | object | Optional. The actor works without a proxy. |
### Example output
```json
{
"imageUrl": "https://p16-sign.tiktokcdn-us.com/...tplv-tiktokx-origin.image",
"hashtagName": "nfl",
"url": "https://ads.tiktok.com/creative/top-hashtag/US/nfl",
"videoViews": 5586066480,
"videoViewsWow": 1.86,
"postCount": 189766,
"postCountWow": 0.57,
"region": "US",
"relatedHashtags": [
{ "name": "superbowl", "videoViews": 3120044120 },
{ "name": "badbunny", "videoViews": 2874531900 }
],
"topVideos": [
{
"title": "AppleMusicHalftime badbunny superbowl nfl",
"url": "https://www.tiktok.com/@tiktok/video/7586449365934427414",
"views": 130412117,
"likes": 10806346,
"comments": 114854,
"shares": 227098,
"author": "creatorname",
"authorUrl": "https://www.tiktok.com/@creatorname",
"cover": "https://p16-sign.tiktokcdn-us.com/...image"
}
],
"observedAt": "2026-07-03T00:15:32.000Z"
}
````
### Frequently Asked Questions
**Does this scraper need a TikTok login or API key?**
No. It reads the public Creative Center hashtag trend data over HTTP, with no account, no login and no API key.
**Why did some of my hashtags return nothing?**
Only hashtags that TikTok includes in its public trend index return data. Very generic or low-volume tags may not be tracked. Leave the Hashtags field empty to let the actor discover trending hashtags that are guaranteed to resolve.
**What does the week-over-week value mean?**
videoViewsWow and postCountWow are growth rates comparing the current week to the previous one. A value of 0.5 means a 50 percent increase, and -0.4 means a 40 percent decrease.
**Are the view and post counts specific to one country?**
TikTok reports global view and post counts for each hashtag. The Region setting selects the market and language context and the canonical hashtag URL, but the counts themselves are global.
**How many hashtags can I collect in one run?**
Set Max Items to control the volume. With trend discovery on, the actor keeps following the related hashtag graph and collecting new hashtags until it reaches your limit.
**What output formats are supported?**
Every run can be exported as JSON, CSV or Excel, or pulled from the Apify dataset API.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of hashtags to collect. Optional.
## `withDetails` (type: `boolean`):
Add the related trending hashtags and the top videos (with views, likes, comments, shares and author) for each hashtag. Turn off for a lighter, metrics-only output.
## `hashtags` (type: `array`):
Specific hashtags to analyze, with or without the leading # (for example booktok, gymtok, halloween). Leave empty to start from trending hashtags. Only hashtags in TikTok's public trend index return data.
## `expand` (type: `boolean`):
Follow the related hashtag graph to discover more trending hashtags until Max Items is reached. Leave on for trending discovery, turn off to analyze only the hashtags you provided.
## `region` (type: `string`):
Market and language context for the hashtag pages. Note that TikTok reports global view and post counts regardless of region.
## `proxyConfiguration` (type: `object`):
Optional. The actor works without a proxy; enable one only if you hit rate limits.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"hashtags": [],
"expand": true,
"region": "US",
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `results` (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 = {
"maxItems": 10,
"hashtags": []
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/tiktok-hashtag-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 = {
"maxItems": 10,
"hashtags": [],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/tiktok-hashtag-analytics-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 '{
"maxItems": 10,
"hashtags": []
}' |
apify call scrapers_lat/tiktok-hashtag-analytics-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/tiktok-hashtag-analytics-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "TikTok Hashtag Analytics & Trends Scraper",
"description": "Scrape TikTok hashtag analytics from the public Creative Center: video views, post counts, week-over-week growth, related trending hashtags and top videos. Discover trending hashtags automatically or analyze your own list. Export JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "K0EO84Ep7vQdfCLLc"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~tiktok-hashtag-analytics-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-tiktok-hashtag-analytics-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/scrapers_lat~tiktok-hashtag-analytics-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-tiktok-hashtag-analytics-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/scrapers_lat~tiktok-hashtag-analytics-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-tiktok-hashtag-analytics-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": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of hashtags to collect. Optional."
},
"withDetails": {
"title": "Include related hashtags and top videos",
"type": "boolean",
"description": "Add the related trending hashtags and the top videos (with views, likes, comments, shares and author) for each hashtag. Turn off for a lighter, metrics-only output.",
"default": true
},
"hashtags": {
"title": "Hashtags",
"type": "array",
"description": "Specific hashtags to analyze, with or without the leading # (for example booktok, gymtok, halloween). Leave empty to start from trending hashtags. Only hashtags in TikTok's public trend index return data.",
"items": {
"type": "string"
}
},
"expand": {
"title": "Discover related trending hashtags",
"type": "boolean",
"description": "Follow the related hashtag graph to discover more trending hashtags until Max Items is reached. Leave on for trending discovery, turn off to analyze only the hashtags you provided.",
"default": true
},
"region": {
"title": "Region",
"enum": [
"US",
"GB",
"CA",
"AU",
"DE",
"FR",
"ES",
"IT",
"BR",
"MX",
"AR",
"CO",
"CL",
"PE",
"JP",
"KR",
"ID",
"TH",
"VN",
"PH",
"MY",
"SG",
"IN",
"TR",
"SA",
"AE",
"EG",
"ZA",
"NG",
"PL",
"NL",
"SE"
],
"type": "string",
"description": "Market and language context for the hashtag pages. Note that TikTok reports global view and post counts regardless of region.",
"default": "US"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. The actor works without a proxy; enable one only if you hit rate limits.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```