# 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:** 9 total users, 3 monthly users, 95.4% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $6.15 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Analytics & Trends Scraper](https://scrapers.lat/banners/tiktok-hashtag-analytics-scraper.png)](https://console.apify.com/actors/HwrMFNahFNVZASh2I/input)

## TikTok Hashtag Analytics & Trends Scraper

> The most complete TikTok hashtag analytics scraper: video views, post counts, week-over-week growth, trend direction, average views per post, engagement rate, related trending hashtags and enriched top videos (video ID, direct video URL, creator profile), with no login or API key

**📥 [Input](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/tiktok-hashtag-analytics-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Trend discovery](https://img.shields.io/badge/Trend-discovery-blue)
![Maintained](https://img.shields.io/badge/Maintained-Yes-brightgreen)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)

<table><tr>
<td align="center"><strong>Views + growth</strong><br>per hashtag</td>
<td align="center"><strong>Trend discovery</strong><br>related hashtag graph</td>
<td align="center"><strong>Enriched top videos</strong><br>ID, direct URL, creator</td>
<td align="center"><strong>Sort + filters</strong><br>min views, only rising</td>
<td align="center"><strong>JSON / CSV / Excel</strong><br>output formats</td>
</tr></table>

<br>

### 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.

### What you get for every hashtag

This is the most complete hashtag record available without a TikTok login:

| Field | What it is |
|---|---|
| `hashtagName`, `url`, `region` | Hashtag, canonical Creative Center URL, market context |
| `videoViews`, `postCount` | Total video views and total posts using the hashtag |
| `videoViewsWow`, `postCountWow` | Week-over-week growth rate for views and posts (0.5 means +50 percent) |
| `trend` | Simple momentum label: rising, flat or falling |
| `avgViewsPerPost` | Views divided by posts, a reach-per-post signal |
| `relatedHashtags` | Related trending hashtags with their own view counts |
| `relatedHashtagCount` | How many related hashtags were returned |
| `topVideos` | Top videos for the hashtag, each with the fields below |
| `topVideoAvgEngagementRate` | Average engagement rate across the top videos |
| `dataUpdatedAt` | When TikTok last refreshed this hashtag on its side |
| `observedAt` | When this actor collected the record |

Each entry in `topVideos` includes `title`, `url`, `videoId`, `views`, `likes`, `comments`, `shares`, `engagementRate`, `author`, `authorUrl`, `authorAvatar`, `creatorMarketplaceUrl`, `videoUrl` (direct video link) and `cover`.

### Filters and sorting

Optional controls, all off by default so the full output is never reduced unless you ask:

- **Sort by**: order results by video views, post count, views growth, posts growth or average views per post (highest first).
- **Only rising hashtags**: keep only hashtags whose views grew week over week, to catch trends early.
- **Minimum video views** and **Minimum post count**: drop low-volume hashtags.
- **Max top videos per hashtag**: cap how many top videos are returned per hashtag.
- **Region** and **Content language**: set the market context and the language of hashtag and video text.

### 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 |

### 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",
  "trend": "rising",
  "avgViewsPerPost": 29437,
  "relatedHashtagCount": 6,
  "topVideoAvgEngagementRate": 8.42,
  "dataUpdatedAt": "2026-07-23T05:10:41.000Z",
  "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": "nfl",
      "authorUrl": "https://www.tiktok.com/@nfl",
      "cover": "https://p16-sign.tiktokcdn-us.com/...image",
      "videoId": "7586449365934427414",
      "engagementRate": 8.549,
      "videoUrl": "https://v77.tiktokcdn.com/...video_mp4",
      "authorAvatar": "https://p16-sign-va.tiktokcdn.com/...cropcenter.png",
      "creatorMarketplaceUrl": "https://ads.tiktok.com/creative/creatormarketplace/creator-profile/6634193109470593000"
    }
  ],
  "observedAt": "2026-07-25T00: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.

**Can I sort results or filter out small hashtags?**
Yes. Use Sort by to order results by views, posts or growth, Only rising hashtags to keep the ones growing week over week, and Minimum video views or Minimum post count to drop low-volume tags. All filters are off by default.

**Does it return a fixed trend rank or industry category?**
No. TikTok keeps the ranked leaderboard and industry classification behind a login, so no keyless scraper can return a true rank number or industry for a hashtag without an account. This actor gives you the growth-based `trend` label and the full growth rates instead, which is the honest public signal.

**What output formats are supported?**
Every run can be exported as JSON, CSV or Excel, or pulled from the Apify dataset API.

### Why teams choose this scraper

- **You are never charged for empty or failed runs** — you only pay for data you actually receive.
- **Maintained and monitored** — if the source site changes, we fix it fast.
- **Clean, typed output** — one record per result, ready for your CRM, spreadsheet or database.

If this scraper saves you time, a quick ⭐ review on Apify helps other people find it and helps us keep improving it.

### 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

## `maxHashtags` (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.

## `sortBy` (type: `string`):

Order the results (highest first). Leave as No sorting to stream hashtags in discovery order. Choosing a sort collects the set and then orders it.

## `onlyRising` (type: `boolean`):

Keep only hashtags whose views grew week over week (positive views growth). Useful for spotting trends early.

## `minVideoViews` (type: `integer`):

Drop hashtags with fewer total video views than this. Leave empty for no minimum.

## `minPostCount` (type: `integer`):

Drop hashtags with fewer posts than this. Leave empty for no minimum.

## `maxTopVideos` (type: `integer`):

Cap how many top videos are returned per hashtag (the source provides up to 5). Leave empty to keep all.

## `lang` (type: `string`):

Language code for hashtag and video text, for example en, es, pt, ja. Defaults to English.

## Actor input object example

```json
{
  "maxHashtags": 10,
  "withDetails": true,
  "hashtags": [],
  "expand": true,
  "region": "US",
  "sortBy": "",
  "onlyRising": false,
  "lang": "en"
}
```

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

// Prepare Actor input
const input = {
    "maxHashtags": 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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxHashtags": 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 '{
  "maxHashtags": 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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/HwrMFNahFNVZASh2I/builds/eAJkAkjXgbxhEJpau/openapi.json
