# TikTok Trends Scraper | Trending Videos, Hashtags & Search (`monkey.d.scraping/tiktok-trends-search-scraper`) Actor

TikTok trending videos by category and country with views, likes, shares, saves, sound and transcripts, plus a trend report: top and rising hashtags, sounds, creators and videos. Also keyword, hashtag and profile search. From $0.15/1K, no login.

- **URL**: https://apify.com/monkey.d.scraping/tiktok-trends-search-scraper.md
- **Developed by:** [Monkey D. Scraping](https://apify.com/monkey.d.scraping) (community)
- **Categories:** Social media, Videos, MCP servers
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event + usage

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Trends Scraper — trending videos, hashtags and sounds by category, plus keyword search, from $0.15 per 1,000

**中文用户：** [简体中文说明](#中文说明tiktok-热门趋势采集工具热门视频话题标签音乐与关键词搜索) · **中文用戶：** [繁體中文說明](#中文說明繁體tiktok-熱門趨勢擷取工具熱門影片主題標籤音樂與關鍵字搜尋)

See what is trending on TikTok right now, category by category. Get the trending videos of 21 Explore categories with views, likes, comments, shares, saves, length, sound and creator stats, and a ready-made **trend report** for each category: top hashtags, top sounds, top creators, average views and engagement, and what is **new or rising since your previous run**: hashtags, sounds and the videos that gained most views. Choose the **country**, read **all 21 categories in one run** and add **transcripts** of the trending videos.

The same Actor also searches TikTok by **keyword**, **hashtag** and **profile**, reads single **video links**, and adds profile and hashtag analytics. One flat row per video, ready for Google Sheets and Excel.

**From $0.25 to $0.15 per 1,000 videos. No start fee, no login, no cookies.** Trend reports, hashtag analytics and creator stats are included at no extra cost.

Output ready for Google Sheets, Excel, n8n, Make, Zapier, Python, JavaScript, the Apify MCP server and AI agents.

### Why this TikTok trends scraper?

| | This Actor | Market leader | Typical low-cost scrapers |
| --- | --- | --- | --- |
| Trending videos by category (21 Explore categories) | ✅ full stats | ❌ | separate Actor, $1.50 → $15 per 1,000 |
| Trend report per category: top hashtags, sounds and creators, average views and engagement | ✅ **included** | ❌ | ❌ |
| New and rising hashtags, sounds and videos since the previous run | ✅ **included** | ❌ | ❌ |
| Trending lists by country | ✅ | ❌ | ❌ |
| All categories in one run, ranked side by side | ✅ **included** | ❌ | ❌ |
| Transcripts of trending videos | ✅ **included** | paid add-on or separate Actor | ❌ |
| Real-time server endpoint for apps and AI agents | ✅ | ❌ | rare |
| Price per 1,000 videos | **$0.25 → $0.15** | $3.70 → $1.70 plus paid add-ons | $0.30 → $0.20 |
| Start fee | **none** | yes | often |
| Keyword search, hashtags, profiles, video links in the same run | ✅ | ✅ | usually one or two |
| Creator followers, likes, bio on every video | ✅ **included** | add-on | add-on |
| Profile analytics: average and median views, posting frequency, last post | ✅ **included** | ❌ | ❌ |
| Hashtag analytics: total views and videos, top creators, related hashtags, top sounds | ✅ **included** | ❌ | ❌ |
| Filters: period, date, minimum likes, minimum views (filtered videos are free) | ✅ | paid add-ons | partial |
| Exact keyword match option | ✅ | ❌ | ❌ |
| Monitor: only videos not returned before | ✅ | ❌ | ❌ |
| Field coverage report for every run | ✅ | ❌ | ❌ |
| Flat, spreadsheet-ready rows | ✅ | nested | nested |
| Documentation in English and Chinese | ✅ | ❌ | ❌ |

Prices and features read from the Apify Store listings on 11 November 2026; Free plan → highest plan.

**Where it is better:**

- **Trends first:** what TikTok shows on Explore right now for Food, Beauty care, Sports, Education, Technology and 16 more categories, every video with views, likes, comments, shares, saves, length and sound.
- **A report, not only rows:** each category comes with its top hashtags, sounds and creators, averages, the hashtags and sounds that are new or rising since the last run of the same task, and the videos that gained most views in between. Schedule it daily and you have a TikTok trend tracker.
- **Every market:** read the trending lists as seen from the United States, the United Kingdom, Italy, Germany, Brazil, Japan and other countries.
- **Words, not only numbers:** transcripts of the trending videos that publish subtitles, for content analysis and AI.
- **Search included:** keywords, hashtags, profiles and single links in the same run and the same dataset, each row marked with its `source` and `input`. Keyword results must name the keyword (plurals and other word forms count), and `searchLanguage` keeps only videos in your language, so social listening starts from on-topic data. In our tests most videos returned for a keyword were not returned by other TikTok search scrapers, so it also works as a second source.
- **Up to 10 times cheaper** than the market leader, with creator stats, profile analytics and hashtag analytics included instead of paid add-ons.
- **Pay only for what you keep:** videos removed by your filters, duplicates and inputs that cannot be read are never charged.

### What can I do with it?

- **Trend research:** follow the trending videos of your category every day and see which hashtags and sounds enter or grow.
- **Content planning for creators, marketers and agencies:** find the formats, lengths and sounds that work now in Food, Beauty care, Fitness, Technology and more.
- **Sound and hashtag discovery:** catch new sounds and hashtags while they rise, and the videos that grow fastest.
- **Market comparison:** compare what trends in different countries and which categories get most views.
- **Script and hook analysis:** read what trending videos say with transcripts.
- **Social listening and brand monitoring:** search your brand, product or campaign keyword every day and get only the new videos.
- **Influencer discovery:** find creators by niche and sort them by followers, likes and average views.
- **Competitor tracking:** list the latest videos of competitor accounts with likes and comments.
- **Datasets for AI and analytics:** captions, hashtags and engagement for training, dashboards and reports.

### How to scrape TikTok trends

1. Choose one or more **Trending categories** (or leave everything empty for the mixed trending list).
2. Optionally add **search keywords**, hashtags, profiles or video links, and set **Max videos per item**, period, sorting and minimum likes or views.
3. Click **Start**. Videos appear in the **Videos** tab; trend reports, profiles and hashtags in their own tabs.
4. Download as JSON, CSV, Excel or HTML, or read the results through the API. Schedule the task to track changes over time.

### Input

| Field | What it does |
| --- | --- |
| `trendingCategories` | Explore categories: `all`, `singing-dancing`, `comedy`, `sports`, `anime-comics`, `relationship`, `shows`, `lipsync`, `daily-life`, `beauty-care`, `games`, `society`, `outfit`, `cars`, `food`, `animals`, `family`, `drama`, `fitness-health`, `education`, `technology` |
| `allTrendingCategories` | Read all 21 categories in one run and add an overall report that ranks them |
| `trendingCountry` | Two-letter country of the trending lists (default United States) |
| `includeTranscripts` | Spoken text of trending videos that publish subtitles (default off, free). Only trending videos: keyword, hashtag, profile and link videos have no transcript |
| `searchQueries` | Keywords or phrases, one per line, or TikTok search links |
| `hashtags` | Hashtags with or without `#`, or hashtag links |
| `profiles` | Usernames with or without `@`, or profile links |
| `videoUrls` | Links to videos or photo posts, short links included. Full links with the username (`tiktok.com/@user/video/…`) give the most complete rows; links without public data are listed as not found in the run summary and are not charged |
| `maxResultsPerItem` | Videos per category, keyword, hashtag or profile (default 50; for profiles 0 returns only the profile row) |
| `sortBy` | `relevance`, `newest` or `mostLiked` |
| `period` | `any`, `day`, `week`, `month`, `year`: exact publishing date. Keywords and hashtags are also searched in shorter ranges inside the period, to find more videos |
| `postedAfter` | Keep videos published on or after a date (YYYY-MM-DD) |
| `minLikes`, `minViews` | Skip videos below these numbers |
| `searchCountry`, `searchLanguage` | Country (default `us`) and optional language of keyword and hashtag results: with `searchLanguage`, videos whose caption is clearly in another language are left out (captions too short to tell are kept) |
| `strictMatch` | For keywords: keep only videos that name every word in caption, hashtags or transcript (default off: at least one word; word forms such as plurals count) |
| `includeAuthorStats` | Creator followers, likes, bio and avatar on every video (default on, free) |
| `onlyNewVideos` | Return only videos not returned by earlier runs of the same task |

#### Example inputs

Trending videos and trend report by category:

```json
{ "trendingCategories": ["food", "beauty-care", "technology"], "maxResultsPerItem": 100 }
```

Daily trend tracker (schedule the task; each report shows what is new or rising since the previous run):

```json
{ "trendingCategories": ["fitness-health"], "maxResultsPerItem": 200 }
```

All categories of a country, ranked side by side:

```json
{ "allTrendingCategories": true, "trendingCountry": "GB", "maxResultsPerItem": 50 }
```

Trending videos with transcripts:

```json
{ "trendingCategories": ["education"], "includeTranscripts": true, "maxResultsPerItem": 50 }
```

Viral videos only:

```json
{ "trendingCategories": ["all"], "maxResultsPerItem": 100, "minViews": 1000000, "period": "week" }
```

Keyword search, last 30 days, most liked first:

```json
{ "searchQueries": ["skincare routine", "sunscreen review"], "maxResultsPerItem": 100, "period": "month", "sortBy": "mostLiked" }
```

Precise keyword search:

```json
{ "searchQueries": ["air fryer recipes"], "strictMatch": true, "maxResultsPerItem": 100 }
```

Social listening in one language (keywords and hashtags in Italian, other languages left out):

```json
{ "searchQueries": ["obbligo vaccinale"], "hashtags": ["vaccini"], "searchCountry": "it", "searchLanguage": "it", "strictMatch": true }
```

Influencer and competitor profiles:

```json
{ "profiles": ["nasa", "@natgeo", "https://www.tiktok.com/@bbcnews"], "maxResultsPerItem": 30 }
```

Hashtag analytics:

```json
{ "hashtags": ["booktok", "#cleantok"], "maxResultsPerItem": 50 }
```

Daily brand monitor (schedule the task):

```json
{ "searchQueries": ["your brand"], "period": "week", "onlyNewVideos": true }
```

### Output

**Trend reports** dataset, one row per trending category:

```json
{
  "category": "food",
  "country": "US",
  "videosAnalyzed": 30,
  "totalViews": 54303100,
  "avgViews": 1810103,
  "medianViews": 1046050,
  "avgEngagementRate": 0.0883,
  "avgDurationSeconds": 59,
  "medianAgeDays": 11.5,
  "topHashtags": [
    {
      "hashtag": "fyp",
      "videos": 7,
      "views": 13296900
    },
    {
      "hashtag": "mukbang",
      "videos": 6,
      "views": 7905000
    }
  ],
  "topSounds": [
    {
      "title": "Nothing Can Change This Love",
      "author": "Sam Cooke",
      "videos": 1,
      "views": 8400000
    },
    {
      "title": "There Is Something On Your Mind",
      "author": "Big Jay McNeely",
      "videos": 1,
      "views": 3100000
    }
  ],
  "topCreators": [
    {
      "username": "aflavorfulbite",
      "followers": 607300,
      "videos": 1,
      "views": 8400000
    },
    {
      "username": "maebaby220",
      "followers": 90200,
      "videos": 1,
      "views": 6800000
    }
  ],
  "topVideoUrl": "https://www.tiktok.com/@aflavorfulbite/video/7701314628961307917",
  "topVideoViews": 8400000,
  "previousRunAt": "2026-11-11T20:04:15Z",
  "hoursSincePreviousRun": 0,
  "newHashtags": [],
  "risingHashtags": [
    {
      "hashtag": "fyp",
      "videos": 7,
      "previousVideos": 6
    },
    {
      "hashtag": "seafood",
      "videos": 3,
      "previousVideos": 1
    }
  ],
  "newSounds": [
    {
      "title": "MORNING DEW (DONK)",
      "videos": 1
    }
  ],
  "risingVideos": [
    {
      "url": "https://www.tiktok.com/@compaaachino/video/7706574339075738893",
      "text": "Raising Canes Mukbang 🍗 A cup of Canes sauce will always hits the spot 🥤 @Raising Cane's  #fyp #mukbang #asmr #foodie #f",
      "views": 329300,
      "previousViews": 329100,
      "gainedViews": 200
    },
    {
      "url": "https://www.tiktok.com/@dannydan668/video/7703605661799583007",
      "text": "Bendiciones de la tierra 🌎",
      "views": 892100,
      "previousViews": 892000,
      "gainedViews": 100
    }
  ]
}
```

`newHashtags`, `risingHashtags`, `newSounds` and `risingVideos` compare the run with the previous run of the same task. With two or more categories the dataset also holds an `overall` row with `categories`: the categories side by side, highest median views first.

**Videos** (default dataset), one row per video:

```json
{
  "id": "7701118331713080597",
  "url": "https://www.tiktok.com/@oneseconduniverse/video/7701118331713080597",
  "type": "video",
  "text": "Looks Like a Flat Plain, But It's the Tallest Volcano in the Solar System #Mars #Astronomy",
  "hashtags": ["mars", "astronomy"],
  "mentions": [],
  "createdAt": "2026-10-27T09:05:00Z",
  "views": 10800000,
  "likes": 2000000,
  "comments": 11100,
  "shares": 48800,
  "saves": 136786,
  "engagementRate": 0.2034,
  "completeness": "full",
  "durationSeconds": 18,
  "authorUsername": "oneseconduniverse",
  "authorNickname": "秒で見る世界",
  "authorFollowers": 498900,
  "authorLikes": 22100000,
  "authorVideos": 490,
  "authorVerified": false,
  "musicTitle": "original sound - 秒で見る世界",
  "musicOriginal": true,
  "coverUrl": "https://p16-common-sign.tiktokcdn-eu.com/…",
  "language": "en",
  "source": "trending",
  "input": "education",
  "rank": 1,
  "category": "education",
  "scrapedAt": "2026-11-11T19:02:11Z"
}
```

Trending videos carry every field, plus `transcript` and `transcriptLanguage` when requested and published by TikTok. Keyword, hashtag and profile videos carry caption, likes, comments, date, cover and creator stats, in any language; views, shares, length and the full caption (when the web result cut it) are added from TikTok's public web player, for photo posts too. The SUMMARY record has an `enrichment` section: how many videos were completed and, if TikTok refused some requests, why. Every video has `language`: TikTok's label for trending videos, otherwise detected from the caption (or the transcript); it is empty when the caption is too short to tell, for example only hashtags.

Every video has `completeness`, so you can filter before you analyze: `full` (views, likes, comments and full caption), `partial` (some of the counts, or only the first part of the caption) or `basic` (caption, date and creator, no counts: TikTok did not publish them for that video).

**Profiles** dataset: username, display name, bio, link in bio, verified, followers, following, total likes, videos, avatar, plus `recentAvgViews`, `recentMedianViews`, `recentMaxViews`, `viewsPerFollower`, `postsPerWeek` and `lastPostedAt`.

**Hashtags** dataset: total views and videos on TikTok, description, videos of the run, average likes and views, top creators, related hashtags and top sounds. For a few very large hashtags TikTok publishes the total videos but not the total views: `totalVideos` is filled and `totalViews` stays empty.

**SUMMARY** record: status of every input, with a plain reason when something could not be read, and `fieldCoverage`: the percentage of saved videos that carry each field (views, likes, comments, shares, saves, length, sound, creator followers), and `videoCompleteness`: how many videos are `full`, `partial` and `basic`.

### Pricing

Pay per event, no start fee, no platform usage on top.

| Event | Free | Starter | Scale | Business and higher |
| --- | --- | --- | --- | --- |
| Video saved | $0.25 / 1,000 | $0.22 / 1,000 | $0.18 / 1,000 | $0.15 / 1,000 |
| Profile row | $1.00 / 1,000 | $0.90 / 1,000 | $0.75 / 1,000 | $0.60 / 1,000 |

Hashtag rows, trend reports, transcripts, creator stats on videos and the SUMMARY record are free. Example: 1,000 videos about a keyword cost $0.25 on the Free plan.

### Use it from code, Make, n8n, Zapier or an AI agent

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("monkey.d.scraping/tiktok-trends-search-scraper").call(run_input={
    "trendingCategories": ["food"], "maxResultsPerItem": 100})
for video in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(video["url"], video["views"], video["musicTitle"])
```

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('monkey.d.scraping/tiktok-trends-search-scraper').call({ hashtags: ['booktok'], maxResultsPerItem: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

#### Real-time API (Server)

Need trending videos or a trend report inside an HTTP response? Use the **Server** tab. Send the same JSON input to `POST /scrape` (or `GET /scrape?category=food`) and get `videos`, `trends`, `profiles` and `hashtags` back in seconds, ready for apps, AI agents, n8n and Make.

```bash
curl -X POST "https://YOUR_SERVER_URL/scrape" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" -H "Content-Type: application/json" \
  -d '{"trendingCategories": ["food"], "maxResultsPerItem": 30}'
```

Copy the server URL from the Server tab. Videos and profile rows cost the same as in a normal run; trend reports and items that cannot be read are free. Normal runs, schedules and dataset exports keep working exactly as before.

The server supports both **single-tenant** (each user gets a separate server run in their own account) and **multi-tenant** (shared server instances, with every request's results kept separate and returned only to its caller). Apify activates one mode at a time; the Server tab shows the active one. To compare a run with the previous one and to monitor only new videos, use a scheduled task.

#### Use it as a tool in Claude, ChatGPT, Cursor and other MCP clients

Add the Apify MCP server (`https://mcp.apify.com`) and enable `monkey.d.scraping/tiktok-trends-search-scraper`. Ask, for example: "What is trending on TikTok in the food category today? List the top hashtags and sounds" or "Find the 50 most liked TikTok videos about air fryer recipes from the last month."

### For AI agents and LLM tools

- **Actor:** `monkey.d.scraping/tiktok-trends-search-scraper` — TikTok trending videos and trend reports by category, plus search by keyword, hashtag, profile and video link.
- **Minimal input:** `{"trendingCategories": ["all"]}` or `{"searchQueries": ["<keyword>"]}`; other inputs: `hashtags`, `profiles`, `videoUrls`; options: `strictMatch`, `sortBy`, `period`, `minLikes`, `minViews`, `onlyNewVideos`.
- **Real-time:** for an answer inside a single HTTP call, use the server endpoint `POST /scrape` with the same input (see the Server tab).
- **Trend options:** `allTrendingCategories`, `trendingCountry`, `includeTranscripts`.
- **Datasets:** default (videos), `profiles`, `hashtags`, `trends` (one report per trending category); `SUMMARY` record with per-input status and `fieldCoverage`.
- **Key output fields:** `url`, `text`, `hashtags`, `createdAt`, `views`, `likes`, `comments`, `shares`, `saves`, `authorUsername`, `authorFollowers`, `source`, `input`.
- **Cost:** $0.25 → $0.15 per 1,000 videos, no start fee.
- **Also known as:** TikTok trends scraper, TikTok trending videos API, TikTok trending hashtags, TikTok trending sounds, TikTok trend tracker, TikTok Explore scraper, TikTok scraper, TikTok search API, TikTok keyword scraper, TikTok hashtag scraper, TikTok profile scraper, TikTok trending videos scraper, TikTok influencer finder, TikTok video data extractor.

### FAQ

**Do I need a TikTok account or cookies?** No. The Actor reads public TikTok content only.

**How do I track trends over time?** Save your input as a task and schedule it. Every trend report compares the run with the previous run of the same task and lists the hashtags and sounds that are new or rising.

**Can I get trends for my country?** Yes: set `trendingCountry` to a two-letter code such as GB, IT, DE, BR or JP.

**Do you provide transcripts?** Yes, for trending videos: turn on `includeTranscripts` and every trending video whose subtitles TikTok publishes (about half to two thirds of them) gets the spoken text and its language. TikTok gives subtitle files only in its trending lists, so videos found by keyword, hashtag, profile or link have no transcript. The SUMMARY record has a `transcripts` section: how many videos had a subtitle file, how many transcripts were added and why the others have none.

**How fresh are the results?** Every run reads TikTok live. Use `period` or `postedAfter` to keep only recent videos, and `onlyNewVideos` on a scheduled task to get only new ones.

**Which countries does it cover?** Videos from any country. `searchCountry` shapes keyword, hashtag and profile results and `searchLanguage` keeps only keyword and hashtag videos in that language; for trending lists use `trendingCountry`.

**Why do hashtag results include other topics?** A hashtag holds every video tagged with it, whatever the meaning: `#novax` covers a vaccine debate and an e-bike brand. For a topic, prefer keywords with `strictMatch`; hashtag videos found by search must carry the hashtag.

**Why do some videos have no likes or views?**
For some videos found by keyword, hashtag or profile TikTok shows the caption but not the counts. They are marked `completeness: basic`; filter on `completeness` to keep only videos with counts. Trending videos always have every count.

**Can I get the video file?** Trending videos include a temporary `videoUrl`; all videos include the cover image.

**Is scraping TikTok legal?** The Actor collects public data only. Make sure your use complies with the laws of your country and with TikTok's terms, especially for personal data.

**Something did not work?** Open the SUMMARY record of the run: each input has a status and a reason. Write to us in the Issues tab.

### Chinese Simplified

### 中文说明：TikTok 热门趋势采集工具（热门视频、话题标签、音乐与关键词搜索）

按 Explore 的 21 个分类采集 TikTok 当前热门视频，包含播放量、点赞、评论、分享、收藏、时长、音乐和创作者数据，并为每个分类生成热门趋势报告：热门话题标签、热门音乐、头部创作者，以及与上次运行相比新出现和上升的标签与音乐。同一工具还支持按关键词、话题标签（hashtag）或账号搜索公开视频。无需登录，无需 Cookie。

#### 为什么选择它？

- **价格低：** 每 1,000 条视频 0.25 美元起，商业版及以上 0.15 美元，无启动费。
- **一个工具五种入口：** 关键词、话题标签、账号、视频链接、热门分类，结果在同一个数据集中。
- **免费附带分析：** 每条视频附创作者粉丝、获赞、简介；账号附最近视频的平均/中位播放量和发布频率；话题标签附总播放量、总视频数、热门创作者和相关标签。
- **热门趋势报告：** 每个热门分类自动生成一份报告：热门话题标签、热门音乐、头部创作者、平均播放量和互动率；定时运行可看到新出现和上升的标签、音乐以及播放量增长最快的视频。
- **按国家/地区查看热门：** `trendingCountry`（如 `US`、`GB`、`JP`、`TW`）；`allTrendingCategories` 一次采集全部 21 个分类并给出分类排名；`includeTranscripts` 附带热门视频的字幕文本（仅限热门视频：TikTok 只在热门列表中提供字幕，关键词、话题标签、账号和链接视频没有字幕文本；SUMMARY 中的 `transcripts` 说明每条视频为何有或没有字幕）。
- **实时接口（Server）：** `POST /scrape` 直接在 HTTP 响应中返回结果，适合应用和 AI 智能体。
- **关键词相关性：** 关键词搜索结果必须包含关键词（文案、标签或字幕文本，复数等词形也算）；开启 `strictMatch` 后，需包含全部关键词。
- **语言：** 每条视频都有 `language` 字段（热门视频取 TikTok 标注，其余根据文案自动识别）；设置 `searchLanguage` 后，文案明显为其他语言的关键词和话题标签视频会被排除。
- **监控模式：** 定时运行时只返回新视频，适合品牌舆情监测。

#### 使用方法

1. 在 `trendingCategories` 中选择热门分类（或填写 `searchQueries`、`hashtags`、`profiles`、`videoUrls`）。
2. 设置每项最多视频数、时间范围、排序和最低点赞/播放量。
3. 点击 Start，结果可导出为 JSON、CSV、Excel。

示例：`{"trendingCategories": ["food", "beauty-care"], "maxResultsPerItem": 100}`；关键词搜索：`{"searchQueries": ["护肤 推荐"], "searchLanguage": "zh", "period": "month", "sortBy": "mostLiked"}`

#### 价格

| 事件 | 免费版 | Starter | Scale | Business 及以上 |
| --- | --- | --- | --- | --- |
| 每条视频 | 0.25 美元/千条 | 0.22 | 0.18 | 0.15 |
| 每个账号 | 1.00 美元/千个 | 0.90 | 0.75 | 0.60 |

#### 常见问题

**需要 TikTok 账号吗？** 不需要，只采集公开内容。
**为什么有些视频没有点赞数或播放量？** 关键词、话题标签和账号视频的播放量、分享数、时长和完整文案来自 TikTok 公开的网页播放器（SUMMARY 中的 `enrichment` 记录补全数量和失败原因）。部分视频 TikTok 只显示文案而不显示数据，这些视频标记为 `completeness: basic`；按 `completeness` 筛选即可只保留有数据的视频。热门视频始终包含全部数据。
**能采集哪些国家？** 任何国家的视频；`searchCountry`（如 `tw`、`sg`、`us`）用于调整搜索结果，`searchLanguage` 只保留该语言的关键词和话题标签视频。
**有字幕文本吗？** 有，仅限热门视频：开启 `includeTranscripts`，TikTok 发布了字幕的热门视频（约一半到三分之二）会附带字幕文本及其语言。

### Chinese Traditional

### 中文說明（繁體）：TikTok 熱門趨勢擷取工具（熱門影片、主題標籤、音樂與關鍵字搜尋）

依 Explore 的 21 個分類擷取 TikTok 目前的熱門影片，含觀看次數、按讚、留言、分享、收藏、長度、音樂與創作者資料，並為每個分類產生趨勢報告：熱門標籤、熱門音樂、熱門創作者，以及與上次執行相比新出現與上升的標籤和音樂。同一工具也可依關鍵字、主題標籤或帳號搜尋公開影片。免登入、免 Cookie。每 1,000 支影片 0.25 美元起，無啟動費。

**使用方法：** 在 `trendingCategories` 選擇熱門分類（或輸入 `searchQueries`、`hashtags`、`profiles`、`videoUrls`），設定數量與篩選條件後按 Start，結果可匯出 JSON、CSV、Excel。範例：`{"trendingCategories": ["food"], "maxResultsPerItem": 100}`；關鍵字搜尋：`{"searchQueries": ["台北 美食"], "searchCountry": "tw", "searchLanguage": "zh"}`

**免費附帶：** 每個熱門分類的趨勢報告（熱門標籤、音樂、創作者、平均觀看與互動率，以及與上次執行相比成長最快的影片）；`trendingCountry` 指定國家／地區（如 `TW`、`HK`、`JP`），`allTrendingCategories` 一次擷取全部 21 個分類，`includeTranscripts` 附上熱門影片的字幕文字（僅限熱門影片：關鍵字、主題標籤、帳號與連結影片沒有字幕文字）；`POST /scrape` 即時介面（Server）；關鍵字結果必須包含關鍵字（文案、標籤或字幕，複數等詞形也算），開啟 `strictMatch` 則需包含全部關鍵字；每支影片都有 `language` 欄位，設定 `searchLanguage` 後會排除文案明顯為其他語言的關鍵字與主題標籤影片。

**常見問題：** 不需要 TikTok 帳號；關鍵字、主題標籤與帳號影片的觀看次數、分享數、長度與完整文案來自 TikTok 公開的網頁播放器（SUMMARY 的 `enrichment` 列出補全數量與失敗原因）；每支影片都有 `completeness` 欄位（`full` 數據完整、`partial` 部分數據、`basic` 只有文案與創作者），可依此篩選；排程任務開啟 `onlyNewVideos` 即可只取得新影片。

### Related Actors by the same author

**More social media scrapers:**

- [Instagram Hashtag Scraper](https://apify.com/monkey.d.scraping/instagram-hashtag-scraper) — posts and reels by hashtag with analytics
- [Instagram Profile, Reels & Keyword Search Scraper](https://apify.com/monkey.d.scraping/instagram-profile-scraper) — profiles, posts and reels
- [YouTube Scraper](https://apify.com/monkey.d.scraping/youtube-scraper) — videos, Shorts, transcripts and comments
- [Facebook Page Posts Scraper & Monitor](https://apify.com/monkey.d.scraping/facebook-page-posts-scraper) — page posts and comments
- [TikTok Ads Library Scraper](https://apify.com/monkey.d.scraping/tiktok-ads-library-scraper) — ads running on TikTok

**More tools for marketers:**

- [Google SERP Scraper](https://apify.com/monkey.d.scraping/google-serp-fast) — Google results from $0.10 per 1,000
- [Telegram Keyword Search Scraper](https://apify.com/monkey.d.scraping/telegram-keyword-search-channel-scraper) — brand mentions on Telegram
- [Google Trends Scraper](https://apify.com/monkey.d.scraping/google-trends-keyword-analysis) — keyword interest over time

# Actor input Schema

## `trendingCategories` (type: `array`):

Videos trending now on TikTok Explore, by category, with full stats: views, likes, comments, shares, saves, duration, sound and creator. Each category also gets a trend report: top hashtags, sounds and creators, and what is new or rising since the previous run. Leave everything empty to get the mixed trending list.

## `allTrendingCategories` (type: `boolean`):

Read every trending category in one run and add an overall report that ranks the categories by views and engagement.

## `searchQueries` (type: `array`):

One per line: words or phrases to search on TikTok (skincare routine, iphone 18 review) or a TikTok search link. Each one returns matching public videos and photo posts with likes, comments, caption and creator stats.

## `hashtags` (type: `array`):

One per line: booktok, #booktok or a hashtag link. Returns videos with the hashtag plus a hashtag row with total views, total videos, top creators, related hashtags and averages.

## `profiles` (type: `array`):

One per line: nasa, @nasa or a profile link. Returns a profile row (followers, likes, bio, average views of the latest videos, posting frequency) and the creator's videos.

## `videoUrls` (type: `array`):

Links to single videos or photo posts, short links included (vm.tiktok.com). Each returns that video with its stats and creator.

## `maxResultsPerItem` (type: `integer`):

Videos kept for each keyword, hashtag, profile or category. For profiles, 0 returns only the profile row.

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

Order of the videos of each item.

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

Keep only videos published in this period (exact publishing date).

## `postedAfter` (type: `string`):

Keep only videos published on or after this date (YYYY-MM-DD).

## `minLikes` (type: `integer`):

Skip videos with fewer likes.

## `minViews` (type: `integer`):

Skip videos with fewer views (videos without a view count are skipped too).

## `searchCountry` (type: `string`):

Two-letter country code that shapes keyword, hashtag and profile results (us, gb, it, de, br, jp, tw…).

## `searchLanguage` (type: `string`):

Optional two-letter language code (en, es, it, zh…). Keyword and hashtag videos whose caption is clearly in another language are left out; videos too short to tell are kept.

## `trendingCountry` (type: `string`):

Two-letter country code (US, GB, IT, DE, BR, JP…) to read the trending lists as seen from that country. Empty: United States.

## `includeTranscripts` (type: `boolean`):

Spoken text of trending videos (trendingCategories) that publish subtitles, with its language. TikTok gives subtitles only in its trending lists: keyword, hashtag, profile and link videos carry no transcript. Free.

## `strictMatch` (type: `boolean`):

For search keywords: keep only videos that name every word of the keyword (caption, hashtags or transcript; plurals and other word forms count). Off: at least one word. Fewer but more precise results.

## `directVideoOnly` (type: `boolean`):

For each video URL, use TikTok player and creator data and skip search and profile fallbacks.

## `includeAuthorStats` (type: `boolean`):

Followers, total likes, bio, avatar and verified badge of each creator, plus view counts of their latest videos. Free.

## `onlyNewVideos` (type: `boolean`):

Skip videos already returned by earlier runs of the same task: schedule the task to get only what is new.

## Actor input object example

```json
{
  "trendingCategories": [
    "all"
  ],
  "allTrendingCategories": false,
  "searchQueries": [],
  "hashtags": [],
  "profiles": [],
  "videoUrls": [],
  "maxResultsPerItem": 50,
  "sortBy": "relevance",
  "period": "any",
  "minLikes": 0,
  "minViews": 0,
  "searchCountry": "us",
  "searchLanguage": "",
  "trendingCountry": "",
  "includeTranscripts": false,
  "strictMatch": false,
  "directVideoOnly": false,
  "includeAuthorStats": true,
  "onlyNewVideos": false
}
```

# Actor output Schema

## `videos` (type: `string`):

One row per video with stats, caption, hashtags, sound and creator.

## `profiles` (type: `string`):

One row per profile asked for, with averages of its latest videos.

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

One row per hashtag asked for, with totals and analytics.

## `trends` (type: `string`):

One row per trending category: top hashtags, sounds and creators, average views and engagement.

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

Status of every input with the reason when something could not be read, and the share of videos carrying each field.

# 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 = {
    "trendingCategories": [
        "all"
    ],
    "searchQueries": [],
    "hashtags": [],
    "profiles": [],
    "videoUrls": [],
    "maxResultsPerItem": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/tiktok-trends-search-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 = {
    "trendingCategories": ["all"],
    "searchQueries": [],
    "hashtags": [],
    "profiles": [],
    "videoUrls": [],
    "maxResultsPerItem": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/tiktok-trends-search-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 '{
  "trendingCategories": [
    "all"
  ],
  "searchQueries": [],
  "hashtags": [],
  "profiles": [],
  "videoUrls": [],
  "maxResultsPerItem": 50
}' |
apify call monkey.d.scraping/tiktok-trends-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/tiktok-trends-search-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/gKkKwocRlTnevJcgB/builds/BeSKl4iq2awBatCKI/openapi.json
