# TikTok Trends Scraper (`fetch_cat/tiktok-trends-scraper`) Actor

Track public TikTok Explore topics, hashtag pages, sounds, and videos for social media research.

- **URL**: https://apify.com/fetch\_cat/tiktok-trends-scraper.md
- **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community)
- **Categories:** Social media, Videos, Marketing
- **Stats:** 2 total users, 0 monthly users, 93.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.15 / 1,000 item extracteds

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 Trends Scraper

Track and export public TikTok Explore topics, hashtag pages, sounds, and video trend records by URL, keyword, country, language, and trend type.

Use this Actor to collect TikTok trend data for social media research, content planning, ecommerce monitoring, creator strategy, campaign tracking, and recurring trend dashboards. Results can be downloaded as CSV, JSON, Excel, XML, RSS, or used through the Apify Dataset API.

### At a glance

- **Trend URL input**: Start from TikTok Discover, hashtag pages, sound pages, or public video URLs.
- **Keyword to hashtag workflow**: Enter keywords such as `travel` or `skincare` and the Actor converts them into TikTok hashtag URLs.
- **Trend records**: Export trend type, rank, title, hashtag, description, video URL, author, sound title, public counts, region label, source URL, and timestamp.
- **Monitoring ready**: Run the same trend inputs on a schedule to build daily or weekly snapshots.
- **API export**: Send TikTok trend rows to spreadsheets, dashboards, content calendars, BI tools, or AI agents.

### Ready-to-run examples

Use these saved Store examples as starting points. Open any example to prefill the Actor input, then adjust URLs, keywords, limits, or filters for your own run.

- **[Archive daily TikTok trend snapshots](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-daily-trend-archive)**
- **[Discover viral topic themes on TikTok](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-viral-topic-discovery)**
- **[Find TikTok content ideas for local businesses](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-local-business-ideas)**
- **[Track seasonal retail trends on TikTok](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-seasonal-retail-trends)**
- **[Run a weekly TikTok brand planning snapshot](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-weekly-brand-planning)**
- **[Create a TikTok trends export for Google Sheets](https://apify.com/fetch_cat/tiktok-trends-scraper/examples/tiktok-google-sheets-report)**
- **[View all ready-to-run examples](https://apify.com/fetch_cat/tiktok-trends-scraper/examples)** (50 examples)

### What can it do?

TikTok Trends Scraper turns public TikTok trend pages and keyword-derived hashtag pages into structured dataset rows.

- **Collect Discover topics**: Use `https://www.tiktok.com/discover` for public Explore topic rows.
- **Track hashtag pages**: Enter hashtag keywords or TikTok `/tag/` URLs.
- **Inspect sound and video URLs**: Add public sound or video URLs when you need source-linked trend records.
- **Label by region and language**: Store your target country and preferred language with each row.
- **Export snapshots**: Use Apify schedules, API calls, webhooks, and integrations for recurring trend monitoring.

### Common workflows

- **Content planning**: Find recurring TikTok topics, hashtags, sounds, and public video examples.
- **Trend dashboards**: Build daily or weekly trend snapshots by region, keyword, or source URL.
- **Ecommerce monitoring**: Track public product, lifestyle, seasonal, or category themes.
- **Campaign research**: Watch hashtag pages around launches, events, creators, or communities.
- **Creator strategy**: Identify content patterns, sound topics, and video examples for ideation.
- **Market research**: Compare public TikTok trend rows across country labels and keyword groups.

### What data can you extract?

The Actor returns one dataset row per public TikTok trend item.

| Field | Description |
| --- | --- |
| `rank` | Rank within the extracted trend list |
| `trendType` | Discover, hashtag, sound, or video |
| `title` | Trend topic, hashtag page title, sound title, or video title |
| `hashtag` | Hashtag when available or derived from the topic |
| `description` | Public trend or topic description when available |
| `videoUrl` | Public TikTok video URL when the input is a video |
| `authorUsername` | Public author username when exposed |
| `soundTitle` | Sound title for sound URLs |
| `viewCount` | Optional public view count |
| `likeCount` | Optional public like count |
| `commentCount` | Optional public comment count |
| `shareCount` | Optional public share count |
| `region` | Country or region label supplied in the input |
| `keywordOrUrl` | Input keyword-derived URL or original URL |
| `sourceUrl` | TikTok URL used for the record |
| `scrapedAt` | ISO timestamp for the run |

### Pricing

This Actor uses Apify pay-per-event pricing. The prices below come from the current Actor pricing configuration. Apify public plans map to Store discount tiers, so the table shows both the user-facing plan context and the pricing tier name. The final price shown in Apify depends on the user account plan and any custom agreement.

| Event | What is charged | Price |
| --- | --- | ---: |
| `start` | One-time fee charged when a run starts. Covers fixed startup cost (init, proxy warmup, first HTTP setup). | $0.005 |

| Event | What is charged | Free / no discount | Starter / Bronze | Scale / Silver | Business / Gold | Custom / Platinum | Custom / Diamond |
| --- | --- | ---: | ---: | ---: | ---: | ---: | ---: |
| `item` | Charged per item extracted. | $0.29425 / 1,000 | $0.25587 / 1,000 | $0.19958 / 1,000 | $0.15352 / 1,000 | $0.10235 / 1,000 | $0.07164 / 1,000 |

Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account.

### Input configuration

| Setting | JSON key | Use it for | Example |
| --- | --- | --- | --- |
| TikTok URLs | `startUrls` | Public TikTok Discover, tag, music, or video URLs to inspect. | `[{"url":"https://www.tiktok.com/discover"}]` |
| Hashtag keywords | `keywords` | Keywords that should be converted into TikTok hashtag URLs. | `["travel", "skincare"]` |
| Default trend type | `trendType` | Fallback type when a URL does not clearly identify its type. | `discover` |
| Country / region code | `country` | Region label stored with each result. | `US` |
| Language code | `language` | Preferred public page language. | `en` |
| Maximum trend items | `maxItems` | Cap saved rows and spend. | `20` |
| Proxy configuration | `proxyConfiguration` | Optional Apify Proxy settings for public TikTok pages. | `{"useApifyProxy":true}` |

### Example input

```json
{
  "startUrls": [
    { "url": "https://www.tiktok.com/discover" }
  ],
  "keywords": ["travel", "skincare"],
  "country": "US",
  "language": "en",
  "trendType": "discover",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

### Example output

```json
{
  "rank": 1,
  "trendType": "hashtag",
  "title": "skincare",
  "hashtag": "skincare",
  "description": "Public TikTok hashtag topic",
  "videoUrl": "https://www.tiktok.com/@creator/video/...",
  "authorUsername": "creator",
  "soundTitle": null,
  "viewCount": 1234567,
  "likeCount": 12345,
  "commentCount": 123,
  "shareCount": 45,
  "region": "US",
  "keywordOrUrl": "skincare",
  "sourceUrl": "https://www.tiktok.com/tag/skincare",
  "scrapedAt": "2026-06-23T14:30:00.000Z"
}
```

### How to run it

1. Open the Actor on Apify.
2. Keep the Discover URL or add public TikTok tag, music, or video URLs.
3. Add optional hashtag keywords.
4. Set country, language, trend type, and `maxItems`.
5. Choose proxy settings if needed.
6. Start the run and export the dataset.

### Search tips

- **Use keyword groups**: Compare related topics such as `travel`, `skincare`, and `fitness`.
- **Keep snapshots small**: Use `maxItems: 20` while testing trend inputs.
- **Schedule the same inputs**: Recurring runs are useful for trend movement over time.
- **Label regions consistently**: Use the same `country` value for comparable trend snapshots.
- **Use URLs for precision**: Paste exact TikTok tag, sound, or video URLs when a keyword is ambiguous.

### Limits and caveats

- The Actor extracts publicly visible TikTok pages only.
- It is not a replacement for private TikTok analytics, creator dashboards, or ad account reporting.
- TikTok may localize, cache, limit, or block public trend pages.
- Some count fields are empty when TikTok does not expose them on the public page.

### Integrations

You can connect TikTok trend data to downstream tools:

- Export CSV or Excel to content calendars and trend trackers.
- Load JSON rows into dashboards for scheduled trend snapshots.
- Trigger webhooks after daily or weekly monitoring runs.
- Send trend rows to AI tools for clustering or content ideation.
- Combine trends with TikTok hashtag, profile, video, and ads datasets.

### API usage

#### Node.js

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tiktok-trends-scraper').call({
  startUrls: [{ url: 'https://www.tiktok.com/discover' }],
  keywords: ['travel', 'skincare'],
  country: 'US',
  maxItems: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/tiktok-trends-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.tiktok.com/discover'}],
    'keywords': ['travel', 'skincare'],
    'country': 'US',
    'maxItems': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~tiktok-trends-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.tiktok.com/discover"}],"keywords":["travel","skincare"],"country":"US","maxItems":20}'
```

### MCP and AI agents

This Actor can be used through the official Apify MCP server at `https://mcp.apify.com`.

For Claude CLI, add the Apify MCP server with this Actor enabled:

```bash
claude mcp add apify --transport http "https://mcp.apify.com?tools=fetch_cat/tiktok-trends-scraper"
```

For MCP clients that use JSON configuration, add:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/tiktok-trends-scraper"
    }
  }
}
```

Example prompts:

- "Find TikTok trend topics for the United States and return the top 20 rows."
- "Scrape TikTok hashtag trend records for travel and skincare."
- "Run fetch\_cat/tiktok-trends-scraper for https://www.tiktok.com/discover with maxItems 10."

Use the same JSON keys shown in the input configuration table, such as `startUrls`, `keywords`, `trendType`, `country`, `language`, and `maxItems`.

### FAQ

#### Can I use this as a TikTok trends API?

Yes. You can run the Actor through the Apify API and read results from the Dataset API.

#### Is this a replacement for TikTok analytics?

No. It extracts public trend pages and public metadata only.

#### Can I schedule daily trend checks?

Yes. Use Apify schedules with the same URLs, keywords, country, and `maxItems` values.

#### Why did I get fewer rows than requested?

TikTok may expose fewer public items for a page, keyword, region, or connection at the time of the run.

### Related scrapers

- [TikTok Hashtag Scraper](https://apify.com/fetch_cat/tiktok-hashtag-scraper)
- [TikTok Profile Scraper](https://apify.com/fetch_cat/tiktok-profile-scraper)
- [TikTok Video Scraper](https://apify.com/fetch_cat/tiktok-video-scraper)
- [TikTok Ads Library Scraper](https://apify.com/fetch_cat/tiktok-ads-library-scraper)
- [YouTube Shorts Scraper](https://apify.com/fetch_cat/youtube-shorts-scraper)

### Support

If a run fails, returns no data, or a field looks wrong, open an issue from the Actor page.

Please include the Apify run ID or run URL, input JSON, one example public URL, query, or input item, what you expected, and what the dataset returned. Small reproducible inputs make parsing or site-layout issues much faster to fix.

### Privacy and data handling

This Actor runs with Apify limited permissions and only processes data needed for the documented run. It uses content lookup inputs and public posts, profiles, videos, comments, or channel metadata needed for the requested output to produce the output dataset and sends requests to public Tiktok Trends pages/endpoints; results are stored in Apify run storage for your account. FetchCat does not use your inputs or outputs for advertising, does not use them for model training, and does not retain them outside the Apify run except for transient support debugging when you explicitly share run details. You are responsible for using the Actor lawfully, respecting the target site's terms, and avoiding unnecessary personal or sensitive data in inputs.

# Actor input Schema

## `startUrls` (type: `array`):

Public TikTok URLs to inspect. Use https://www.tiktok.com/discover for ranked Explore topics, or add public /tag/, /music/, and /video/ URLs.

## `keywords` (type: `array`):

Optional hashtag keywords. For example, travel becomes https://www.tiktok.com/tag/travel.

## `trendType` (type: `string`):

Default type used when a URL does not clearly identify its type. URL paths such as /tag/ and /music/ are detected automatically.

## `country` (type: `string`):

Optional ISO country code stored with each result, such as US, GB, DE, or FR.

## `language` (type: `string`):

Preferred page language for TikTok public pages.

## `maxItems` (type: `integer`):

Maximum number of trend records to save.

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

Optional proxy settings. Datacenter proxy is usually enough for public discovery pages; use residential only if TikTok blocks your region.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.tiktok.com/discover"
    }
  ],
  "keywords": [
    "travel",
    "skincare"
  ],
  "trendType": "discover",
  "country": "US",
  "language": "en",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://www.tiktok.com/discover"
        }
    ],
    "keywords": [
        "travel",
        "skincare"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("fetch_cat/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 = {
    "startUrls": [{ "url": "https://www.tiktok.com/discover" }],
    "keywords": [
        "travel",
        "skincare",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("fetch_cat/tiktok-trends-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 '{
  "startUrls": [
    {
      "url": "https://www.tiktok.com/discover"
    }
  ],
  "keywords": [
    "travel",
    "skincare"
  ]
}' |
apify call fetch_cat/tiktok-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=fetch_cat/tiktok-trends-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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