# TikTok Trends Scraper — Trending Hashtags by Country (`rastriq/tiktok-trends-scraper`) Actor

Extract trending hashtags from TikTok Creative Center. Get ranked hashtag data with view counts, post volumes, and industry tags across 27 countries. Export to JSON, CSV, or Excel. No login required.

- **URL**: https://apify.com/rastriq/tiktok-trends-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Social media
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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 Trends Scraper — Trending Hashtags from TikTok Creative Center

![tiktok trends](https://www.rastriq.es/readme/intel.png)

Extract trending hashtags from TikTok Creative Center across 27 countries. TikTok Trends Scraper delivers ranked hashtag data with view counts, post volumes, and industry tags — ready to export as JSON, CSV, or Excel for your marketing and research workflows.

> Try it free — your first $5 of usage is on Apify. No credit card required.

### What is TikTok Trends Scraper?

**TikTok Trends Scraper** pulls real-time trending hashtag data directly from TikTok's Creative Center — the same dashboard used by advertisers and content strategists worldwide. Instead of manually browsing the Creative Center country by country, this scraper automates the process and gives you structured, exportable data in seconds.

Use TikTok Trends Scraper to:

- **Track viral hashtags** — discover what's trending right now in any market, from the US to Japan to Brazil
- **Monitor competitor campaigns** — see which hashtags gain traction in your industry (Beauty, Tech, Food, Sports, and more)
- **Plan content strategy** — identify high-engagement hashtags before they peak, across multiple time windows (7, 30, or 120 days)
- **Automate trend reports** — schedule daily or weekly runs to keep your team updated without manual effort

### What data does TikTok Trends Scraper extract?

Each result includes a complete picture of the trending hashtag:

|                          |                                    |
| ------------------------ | ---------------------------------- |
| #️⃣ Hashtag name and ID   | Rank in the trending list          |
| Views (total video views)| Posts (number of published videos) |
| Industry classification  | Country and time period            |
| Direct link to Creative Center detail page | Extraction timestamp |

When you enable **Include Detail Page Data**, TikTok Trends Scraper also extracts:

- Audience age and gender distribution
- Regional popularity breakdown
- Related trending videos
- Trend curve over the selected period

### How to use TikTok Trends Scraper

Getting trending TikTok hashtag data takes under a minute:

1. **Create a free Apify account** at [apify.com](https://apify.com) — your first $5 is free
2. **Open TikTok Trends Scraper** in the Apify Console or click **Try for free** on this page
3. **Select your countries** — pick one or more from 27 supported markets
4. **Choose a time period** — 7 days (latest trends), 30 days, or 120 days (long-term patterns)
5. **Click Start** and wait ~40 seconds per country
6. **Download your results** in JSON, CSV, Excel, or XML — or pull them via the Apify API

### Input parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `countries` | array | Yes | `["US"]` | Countries to scrape (ISO 2-letter codes). 27 markets available |
| `period` | string | Yes | `"7"` | Time window: `"7"`, `"30"`, or `"120"` days |
| `industry` | string | No | All | Filter by industry: Beauty, Tech, Food, Sports, Health, and 10 more |
| `maxItemsPerType` | integer | No | `50` | Maximum hashtags to extract per country (1–100) |
| `includeDetails` | boolean | No | `false` | Extract extended data: audience demographics, regional popularity, trend curve |

**Example input:**

```json
{
  "countries": ["US", "GB", "DE"],
  "period": "7",
  "industry": "Beauty & Personal Care",
  "maxItemsPerType": 20,
  "includeDetails": false
}
```

### Output example

Each result is a structured JSON object. Here's a sample from a real run:

```json
{
  "type": "hashtag",
  "country": "US",
  "period_days": 7,
  "rank": 1,
  "hashtag_name": "dollyparton",
  "hashtag_id": "2534",
  "industry": "News & Entertainment",
  "publish_count": 305100,
  "video_views": 1500000000,
  "detail_url": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/2534?region=US&period=7",
  "scraped_at": "2026-08-29T21:51:36.559171+00:00"
}
```

```json
{
  "type": "hashtag",
  "country": "US",
  "period_days": 7,
  "rank": 5,
  "hashtag_name": "guccimorty",
  "hashtag_id": "7675862627465035807",
  "industry": null,
  "publish_count": 22000,
  "video_views": 144000000,
  "detail_url": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/7675862627465035807?region=US&period=7",
  "scraped_at": "2026-08-29T21:51:36.559171+00:00"
}
```

Download results in **JSON, CSV, Excel, XML, or HTML** from the Output tab, or pull them programmatically using the Apify API.

### See real records before you run it

[Browse sample data](https://console.apify.com/storage/datasets/XHdeV0iPr46bfbFYL) extracted by this Actor — fields, format and structure, ready to inspect before your first run.

### How much does it cost to use TikTok Trends Scraper?

**$1.00 per 1,000 hashtags** (+ $0.025 per start). Your $5 free trial credit covers ~4,900 hashtags.

### 🔗 Related Rastriq Actors

#### TikTok Creative Center

| Actor | What it adds |
| --- | --- |
| [TikTok Top Ads Scraper](https://apify.com/rastriq/tiktok-top-ads-scraper) | Top-performing ad creatives — CTR, likes, video URLs, landing pages across 49 countries and 21 industries |
| [TikTok Trending Videos Scraper](https://apify.com/rastriq/tiktok-trending-videos-scraper) | Trending videos with creator profiles, engagement rates and 6-second view-through rates |

#### Ad library scrapers

Extract the actual ads running on each platform — all four share a [normalized output schema](https://www.rastriq.es/en/ad-libraries/).

| Actor | What it adds |
| --- | --- |
| [TikTok Ad Library Scraper](https://apify.com/rastriq/tiktok-ad-library-scraper) | Real ads from TikTok's EU transparency archive — creatives, targeting, spend and audience data |
| [Facebook Ad Library Scraper](https://apify.com/rastriq/fb-adlibrary-scraper) | Ad creatives from Facebook and Instagram |
| [Google Ads Transparency Scraper](https://apify.com/rastriq/google-ads-scraper) | Search, Display and YouTube ads from Google's Ads Transparency Center |
| [LinkedIn Ad Library Scraper](https://apify.com/rastriq/linkedin-ad-library-scraper) | B2B ad intelligence — impressions by country, paying entity and targeting |

#### Competitive intelligence

| Actor | What it adds |
| --- | --- |
| [SimilarWeb Data Extractor](https://apify.com/rastriq/similarweb-data-extractor) | Traffic estimates and top pages for the landing pages these ads point to |

### Copy to your AI assistant

Copy the Apify Store URL for this Actor and paste it into ChatGPT, Claude, or any LLM with web access:

```
https://apify.com/rastriq/tiktok-trends-scraper
```

The model will read the Actor description, input schema, and field list — then help you build the right API call or integration.

### About the data

This Actor is built and maintained by [Rastriq](https://www.rastriq.es), a data intelligence company specializing in structured extraction for market research and competitive analysis. Browse our full [field reference and methodology](https://www.rastriq.es/en/competitive-intelligence/#campos).

### Frequently Asked Questions

#### Is scraping TikTok Creative Center data legal?

TikTok Trends Scraper only accesses **publicly available data** from TikTok's Creative Center — information visible to any visitor without logging in. We apply reasonable rate limiting to avoid overloading their servers.

As with any data collection activity, you are responsible for ensuring your use case complies with applicable laws (GDPR, CCPA) and TikTok's Terms of Service. For guidance, see [Apify's blog on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

#### Does TikTok Trends Scraper require a TikTok account?

No. TikTok Trends Scraper works entirely with **public data** from the Creative Center and does not require any account or API credentials.

#### How many hashtags can I extract?

Up to 100 trending hashtags per country per run. With 27 countries available, that's up to 2,700 hashtags in a single execution.

#### Which countries are supported?

TikTok Trends Scraper supports 27 markets: US, UK, France, Germany, Italy, Spain, Argentina, Australia, Brazil, Canada, Colombia, Egypt, Indonesia, Israel, Japan, South Korea, Malaysia, Mexico, Philippines, Saudi Arabia, Singapore, South Africa, Taiwan, Thailand, Turkey, UAE, and Vietnam.

#### How do I integrate TikTok Trends Scraper with my workflow?

TikTok Trends Scraper integrates natively with:

- **Make (formerly Integromat)** and **Zapier** — trigger runs and receive data automatically
- **Google Sheets** — export directly to a spreadsheet
- **Webhooks** — get notified when a run finishes
- **Apify API** — call from Python, Node.js, or any language (see the API tab)

#### I found a bug or my run failed. Where do I report it?

Please open an issue in the **Issues tab** on this page. Include your input configuration and the run ID so we can investigate quickly.

# Actor input Schema

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

Countries to scrape trends for. Each country runs independently.

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

Time window for trend analysis.

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

Filter hashtags by industry. Leave empty for all.

## `maxItemsPerType` (type: `integer`):

Maximum hashtags to extract per country (up to 100).

## `includeDetails` (type: `boolean`):

Extract extended data per hashtag: audience age distribution, regional popularity, related videos, and trend curve. Increases runtime ~2s per hashtag.

## `trendTypes` (type: `array`):

Types of trends to extract.

## `tiktokCookies` (type: `string`):

TikTok session cookies (JSON).

## `cookieKvStoreId` (type: `string`):

KV Store ID for shared cookies.

## `apifyToken` (type: `string`):

Personal API token for KV Store access.

## Actor input object example

```json
{
  "countries": [
    "US"
  ],
  "period": "7",
  "industry": "",
  "maxItemsPerType": 50,
  "includeDetails": false,
  "trendTypes": [
    "hashtags"
  ],
  "cookieKvStoreId": "3Pc5Q20nhP6Vr6bpG"
}
```

# Actor output Schema

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

Trending hashtags from TikTok Creative Center

# 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",
    "maxItemsPerType": 50,
    "trendTypes": [
        "hashtags"
    ],
    "cookieKvStoreId": "3Pc5Q20nhP6Vr6bpG"
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/tiktok-trends-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",
    "maxItemsPerType": 50,
    "trendTypes": ["hashtags"],
    "cookieKvStoreId": "3Pc5Q20nhP6Vr6bpG",
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/tiktok-trends-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",
  "maxItemsPerType": 50,
  "trendTypes": [
    "hashtags"
  ],
  "cookieKvStoreId": "3Pc5Q20nhP6Vr6bpG"
}' |
apify call rastriq/tiktok-trends-scraper --silent --output-dataset

```

## MCP server setup

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