# TikTok Trending Hashtags Scraper - Country & Industry Charts (`seemuapps/tiktok-trending-hashtags-scraper`) Actor

Get trending TikTok hashtags by country, industry and 7/30/90-day window: rank, posts, views, popularity curve, trend stage and top creators.

- **URL**: https://apify.com/seemuapps/tiktok-trending-hashtags-scraper.md
- **Developed by:** [Seemu Scraping](https://apify.com/seemuapps) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.50 / 1,000 trending hashtags

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Trending Hashtags Scraper - Country & Industry Charts

Get the trending TikTok hashtags for any of 27 countries, broken down by industry and by a 7, 30 or 90-day window. Every hashtag comes with its chart rank, post count, video views, a daily popularity curve, a ready-made trend stage (rising, peaking, steady or fading) and the top creators using it. No TikTok account or login needed.

### What you get

For each trending hashtag:

- **Rank** and the **chart** it ranks in (all industries, or an industry like Beauty & Personal Care or Games)
- **Hashtag**, hashtag ID and a link to the TikTok hashtag page
- **Post count**, **video views** and **views per post** for the selected window
- **Industries** the hashtag is tagged with
- **Ranked in**: every chart the hashtag appears in, with its rank in each (a tag can top both the overall and an industry chart)
- **Popularity curve**: one point per day on a 0-100 index (7, 30 or 90 points)
- **Trend stage** (rising / peaking / steady / fading), **momentum** and **peak date**, computed from the curve
- **Top creators** posting with the hashtag: username, nickname, follower count and profile link
- Country code, country name, window length and scrape time

Export to JSON, CSV, Excel or Google Sheets from the **Dataset** tab, or pull results through the API.

### Use cases

- **Content planning**: find the hashtags gaining momentum in your market before they peak
- **Social media marketing**: pick niche hashtags per industry instead of guessing
- **Trend research and market research**: compare what is trending across countries and verticals
- **Influencer discovery**: see which creators are driving each trending hashtag
- **Agency reporting**: drop a weekly trending-hashtag snapshot into client reports

### How to use

1. Pick one or more **Countries**
2. Choose a **Time period**: last 7, 30 or 90 days
3. Choose an **Industry**:
   - **Every industry** (default) combines the overall chart with all 15 industry charts, about 40-48 unique hashtags per country
   - A single industry returns that industry's chart
   - **Overall chart only** returns the top hashtags across all industries
4. Set **Max results** to cap the number of hashtags per run (0 = no limit)
5. Click **Start**. Results appear in the **Dataset** tab

### How many hashtags will I get?

TikTok shows signed-out visitors the **top 3 hashtags for each chart** (one country, one window, one industry). Any tool that skips login hits the same limit, and "top 100" claims don't change it. This actor gets more out of each country by reading all 16 charts (overall plus 15 industries) and merging them into one de-duplicated list:

| Setting | Hashtags per country |
|---|---|
| Every industry | about 40-48 |
| One industry | 3 |
| Overall chart only | 3 |

If you want a bigger picture, add more countries, or run the 7, 30 and 90-day windows separately.

### Supported countries

United States, United Kingdom, Canada, Australia, Germany, France, Italy, Spain, Argentina, Brazil, Colombia, Mexico, Egypt, Israel, Saudi Arabia, United Arab Emirates, Turkey, South Africa, Indonesia, Japan, South Korea, Malaysia, Philippines, Singapore, Taiwan, Thailand and Vietnam.

### Industries

Education, Vehicle & Transportation, Baby, Kids & Maternity, Beauty & Personal Care, Tech & Electronics, Travel, Household Products, Pets, Home Improvement, Apparel & Accessories, News & Entertainment, Games, Food & Beverage, Sports & Outdoor and Health.

### Input example

```json
{
  "countries": ["US", "GB"],
  "period": "7",
  "industry": "all",
  "maxResults": 100,
  "includeTopCreators": true
}
```

### Output example

```json
{
  "rank": 3,
  "chart": "All industries",
  "hashtag": "livecanbeeasy",
  "hashtagId": "7534678037321744414",
  "hashtagUrl": "https://www.tiktok.com/tag/livecanbeeasy",
  "postCount": 21285,
  "viewCount": 30155625,
  "viewsPerPost": 1417,
  "industries": ["News & Entertainment"],
  "rankedIn": [
    { "chart": "All industries", "rank": 3 },
    { "chart": "News & Entertainment", "rank": 1 }
  ],
  "trendStage": "peaking",
  "momentum": 44.1,
  "peakDate": "2026-10-14",
  "popularityCurve": [
    { "date": "2026-10-09", "value": 0 },
    { "date": "2026-10-10", "value": 4.12 },
    { "date": "2026-10-15", "value": 99.2 }
  ],
  "topCreators": [
    {
      "rank": 1,
      "username": "examplecreator",
      "nickname": "Example",
      "followers": 92685,
      "profileUrl": "https://www.tiktok.com/@examplecreator",
      "avatarUrl": "https://p16-common-sign.tiktokcdn.com/..."
    }
  ],
  "country": "US",
  "countryName": "United States",
  "periodDays": 7,
  "scrapedAt": "2026-10-18T07:49:15.191Z"
}
```

### Field notes

- **popularityCurve** is TikTok's normalised index: the busiest day in the window is always 100, so it shows shape, not volume.
- **trendStage**: `rising` = peaked in the last few days of the window, `peaking` = still at 70+ on the last day, `fading` = last day under half of the peak, `steady` = everything else.
- **momentum** = last day's index minus the window average. Positive means the hashtag is above its usual level.
- TikTok doesn't publish rank changes, so there is no "rank change" field.

### Pricing

You pay per hashtag saved to the dataset. Hashtags that are skipped or not returned are not charged. A full "Every industry" sweep of one country is about 40-48 hashtags.

### FAQ

**Do I need a TikTok account?** No. The actor reads the same public trend charts a signed-out visitor sees.

**Why only 3 hashtags per chart?** That is all TikTok shows without a login. Use **Every industry** to combine 16 charts per country.

**Is there a 120-day window?** No. TikTok now offers 7, 30 and 90 days.

**How fresh is the data?** The charts are read live on every run. The popularity curve normally ends a day or two before the run date.

# Actor input Schema

## `countries` (type: `array`):

Countries to get trending hashtags for. Each country is a separate chart (27 supported markets).

## `period` (type: `string`):

Trending window: the last 7, 30 or 90 days.

## `industry` (type: `string`):

'Every industry' combines the overall chart with all 15 industry charts (about 40-48 unique hashtags per country). Pick one industry for just that chart (top 3), or 'Overall chart only' for the top 3 across all industries.

## `maxResults` (type: `integer`):

Maximum number of hashtags to save across the whole run. 0 = no limit.

## `includeTopCreators` (type: `boolean`):

Add the top creators posting with each hashtag (username, nickname, followers, profile link).

## Actor input object example

```json
{
  "countries": [
    "US"
  ],
  "period": "7",
  "industry": "all",
  "maxResults": 100,
  "includeTopCreators": true
}
```

# Actor output Schema

## `results` (type: `string`):

One row per trending hashtag per country: rank, chart, posts, views, industries, popularity curve, trend stage and top creators.

## `summary` (type: `string`):

Hashtags saved per country, period and industry setting.

# 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 = {
    "countries": [
        "US"
    ],
    "period": "7",
    "industry": "all",
    "maxResults": 100
};

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

# Prepare the Actor input
run_input = {
    "countries": ["US"],
    "period": "7",
    "industry": "all",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/tiktok-trending-hashtags-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "countries": [
    "US"
  ],
  "period": "7",
  "industry": "all",
  "maxResults": 100
}' |
apify call seemuapps/tiktok-trending-hashtags-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/tiktok-trending-hashtags-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9LuOnacN5SuUMcYvJ/builds/nnNTxZRSU9pNDdUmV/openapi.json