# TikTok Trending Hashtags Scraper by Country (`s_actors/tiktok-trending-hashtags-scraper`) Actor

Trending TikTok hashtags by country from TikTok Creative Center: posts, views, daily popularity curve, rising or falling, industries and top creators. About 45 per country across all 15 industries, not just the top 3. New-hashtag alerts.

- **URL**: https://apify.com/s_actors/tiktok-trending-hashtags-scraper.md
- **Developed by:** [Superior Actors](https://apify.com/s_actors) (community)
- **Categories:** Social media, Marketing, AI
- **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 hashtags

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/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 by Country

Get the **hashtags trending on TikTok in any of 27 countries** from TikTok Creative Center: posts, views, a **daily popularity curve**, whether the hashtag is **rising, peaking or falling**, the industries it trends in and its **top creators**. The logged-out Creative Center shows only the **top 3 hashtags** per filter since its 2026 redesign; this Actor reads the ranking of **every one of the 15 industries** and merges them: **about 45 trending hashtags per country** in one run.

```json
{ "countries": ["US", "GB", "BR"], "period": "7" }
```

No TikTok login, no cookies, no browser. Use it as a **TikTok trending hashtags API**, or schedule it with **Only new hashtags** to get an alert when a new hashtag starts trending.

#### What you get

Real example, October 2026, United States, last 7 days:

| # | hashtag | posts | views | trend | industry ranks |
|---|---|---|---|---|---|
| 1 | reggie | 71,821 | 789,016,635 | rising | News & Entertainment #1 |
| 2 | cornell | 47,323 | 559,097,435 | rising | Education #1 |
| 3 | cornelluniversity | 47,030 | 424,137,221 | rising | — |
| 4 | janedoe | 35,146 | 166,830,482 | peaking | News & Entertainment #2, Games #1 |
| 5 | tylil | 4,399 | 101,829,875 | rising | Sports & Outdoor #1 |
| 6 | fortnitemares | 9,484 | 87,759,540 | rising | Games #3 |

| Field | Description |
|---|---|
| `hashtag`, `hashtagUrl`, `hashtagId` | The hashtag and its TikTok page |
| `posts`, `views` | Posts and video views of the hashtag in the period (Creative Center's numbers) |
| `trend` | `rising`, `peaking`, `steady` or `falling`, from the daily curve |
| `popularityCurve` | TikTok's popularity index for every day of the period (100 = the period's peak) |
| `industries`, `industryRanks` | The industries of the hashtag and its place in each industry ranking |
| `overallRank` | Place in Creative Center's overall top 3 (empty for the others) |
| `topCreators` | The creators TikTok shows for the hashtag: username, name, followers, profile link |
| `country`, `periodDays`, `position` | Country, period and our order: the overall top 3 first, then by views |
| `isNew` | Not in the previous run of this monitor (empty on the first run) |
| `creativeCenterUrl`, `scrapedAt` | The Creative Center page and the time of the run |

#### How it works

1. Choose **countries**: US, FR, DE, IT, ES, GB, AR, AU, BR, CA, CO, EG, ID, IL, JP, KR, MY, MX, PH, SA, SG, ZA, TW, TH, TR, AE, VN (the countries Creative Center ranks)
2. Choose the **period**: last 7, 30 or 90 days
3. Optional: only some **industries**, or **Only new hashtags** for scheduled runs
4. Run, then download the dataset as CSV, Excel, JSON or HTML

#### Why this Actor

| | |
|---|---|
| 📈 **~45 hashtags, not 3** | Since the 2026 Creative Center redesign a logged-out visitor sees the top 3 hashtags per filter. The Actor reads all 15 industry rankings and merges them, with each hashtag's place in every industry |
| 📉 **Trend direction** | The daily popularity curve and a simple label: catch a hashtag while it is rising, skip the ones already falling |
| 👤 **Top creators** | Who leads each hashtag, with followers: ready for influencer research |
| 🔔 **New-hashtag alerts** | `isNew` on every row; **Only new hashtags** returns just the ones that started trending since the previous run |
| 🌍 **27 countries in one run** | ~1,200 hashtags for all countries in under a minute |
| 💰 **$0.99 per 1,000 hashtags** | No subscription, no paid start |

#### Track new trending hashtags

1. Choose the countries and turn on **Only new hashtags**
2. Save as a task and add a schedule, e.g. every morning
3. The **first run** returns the whole ranking as a baseline. **Every later run** returns only new hashtags: send them to [Google Sheets](https://apify.com/s_actors/google-sheets-import-export), Slack or email with an integration

The memory is kept in your account (key-value store `tiktok-trending-hashtags-state`). Use a different **Monitor name** for each task.

#### Pricing

Pay per hashtag, no subscription needed. Apify Scale and Business plans pay less:

| Event | Free and Starter plans | Scale plan | Business plan |
|---|---|---|---|
| Run start | $0.001 | $0.001 | $0.001 |
| Hashtag (one row) | $0.00099 | $0.00074 | $0.00049 |

| Task | Cost |
|---|---|
| Trending hashtags of one country (~45) | ~$0.05 |
| All 27 countries (~1,200) | ~$1.20 |
| Daily new-hashtag alert for 5 countries (~10 new a day each) | ~$1.50 per month |

#### Ready-made tasks

Open it, change the countries, and run:

| Task | What you get |
|---|---|
| [Trending TikTok Hashtags by Country Today](https://apify.com/s_actors/tiktok-trending-hashtags-scraper/examples/trending-tiktok-hashtags-by-country) | Trending hashtags of the US, UK, Canada, Australia and Germany |

#### FAQ

**Why do other tools return only 3 hashtags?** TikTok Creative Center (now "TikTok One Creative Suite") shows a logged-out visitor the top 3 hashtags of a filter. The Actor asks for the overall ranking and every industry ranking and merges the answers.

**Why only 27 countries?** These are the countries Creative Center ranks hashtags for.

**What do the numbers mean?** `posts` and `views` are Creative Center's counts for the chosen period, not the hashtag's all-time totals. `popularityCurve` is TikTok's daily popularity index.

**Do I need a TikTok account or cookies?** No.

#### Use with the API and AI agents

Run it via the [Apify API](https://docs.apify.com/api/v2) from Python, Node.js or any HTTP client, or connect it to Claude, ChatGPT and other AI agents through the [Apify MCP server](https://mcp.apify.com): "What hashtags are trending on TikTok in Brazil this week, and which ones are new since yesterday?"

#### Other tools

| Tool | What it does |
|---|---|
| [TikTok Trending Videos Scraper](https://apify.com/s_actors/tiktok-trending-videos-scraper) | Top TikTok videos by country: ~80 per country (not just the top 4), period and organic views, engagement, likes, creators, new-video alerts |
| [TikTok Video Scraper](https://apify.com/s_actors/tiktok-video-scraper) | Views, likes, shares, hashtags and sound of TikTok videos, MP4 download, views tracker |
| [TikTok Comments Scraper](https://apify.com/s_actors/tiktok-comments-scraper) | Comments and replies of TikTok videos and profiles, keyword filter, only-new alerts |
| [TikTok Transcript Scraper](https://apify.com/s_actors/tiktok-transcript-scraper) | Transcripts and subtitles of TikTok videos and profiles: text, SRT, VTT, translations |
| [TikTok Followers Scraper](https://apify.com/s_actors/tiktok-followers-scraper) | Followers and following lists of TikTok profiles: bio emails, follow time, new followers and unfollows |
| [TikTok Viral Videos & Explore Scraper](https://apify.com/s_actors/tiktok-explore-scraper) | Viral TikTok videos from the Explore page in any country and 21 categories: plays, likes, plays per hour, creators, new-video alerts |
| [TikTok Trending Sounds & Songs Scraper](https://apify.com/s_actors/tiktok-trending-sounds-scraper) | Trending TikTok sounds and songs by country and Explore category: videos using each sound, plays, creators, commercial use, MP3 |
| [YouTube Search Scraper](https://apify.com/s_actors/youtube-search-scraper) | YouTube search results with filters: videos, Shorts, channels, playlists |
| [Google Sheets Import & Export](https://apify.com/s_actors/google-sheets-import-export) | Send the trends to a Google Sheet |

# Actor input Schema

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

Countries whose trending hashtags you want. TikTok Creative Center ranks hashtags in these 27 countries.

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

Ranking period: hashtags trending over the last 7, 30 or 90 days.

## `industries` (type: `array`):

Only hashtags of these industries. Empty = the overall ranking plus every industry (about 45 hashtags per country). Each row lists the industries it ranks in and its place there.

## `onlyNew` (type: `boolean`):

For scheduled runs (save the input as a task and add a schedule). The first run returns the whole ranking and remembers it; every later run returns only hashtags that were not in it before. Without it, every row still has isNew.

## `monitorName` (type: `string`):

Name of the memory used by isNew and Only new entries. Use a different name for each task.

## `maxConcurrency` (type: `integer`):

How many requests to TikTok run at the same time.

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

Requests go direct first and switch to Apify datacenter proxies when TikTok refuses them. The default works for most runs.

## `debugLog` (type: `boolean`):

Log every retried request (for troubleshooting).

## Actor input object example

```json
{
  "countries": [
    "US"
  ],
  "period": "7",
  "onlyNew": false,
  "monitorName": "default",
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugLog": false
}
```

# Actor output Schema

## `hashtags` (type: `string`):

Hashtags with posts, views, trend, industries and top creators.

## `all` (type: `string`):

Every field of every row, with the daily popularity curve.

# 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"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("s_actors/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"] }

# Run the Actor and wait for it to finish
run = client.actor("s_actors/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"
  ]
}' |
apify call s_actors/tiktok-trending-hashtags-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,s_actors/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/hKPh7JgYrFcf1EVaO/builds/vCx2jWfpiD4YufEAn/openapi.json