Douyin Hot Search Scraper exports the current public Douyin (抖音) hot-search ranking as structured data for trend monitoring, market research, editorial planning, and Chinese-market analysis. Use this focused Douyin scraper and Douyin API workflow to capture a current topic snapshot with ranks, heat, video metrics, badges, timestamps, and public source links.
Who is it for?
- Market researchers comparing fast-moving Douyin conversations.
- Content and social teams planning topics around current trends.
- Analysts and developers who need a reproducible current-board snapshot in a dataset or API workflow.
What you get
- The ranked Hot list (抖音热榜) topics.
- The optional real-time rising (实时上升热点) strip as a separate
boardvalue. - Topic-level heat, video and discussion metrics, badges, event times, cover images, and public source metadata.
Use cases
- Capture scheduled snapshots for a trend-monitoring dashboard.
- Compare topic rank and heat between successive runs.
- Find timely research or content-planning themes for the Chinese market.
- Export Douyin data into a warehouse, spreadsheet, or agent workflow.
Input settings
| Input | Default | Description |
|---|---|---|
maxItems |
20 |
Maximum topics to save (1–100). |
includeRisingTopics |
true |
Include the public real-time rising strip. |
Output example
{
"board": "hot",
"boardName": "Hot list (抖音热榜)",
"rank": 1,
"word": "Example trending topic",
"hotValue": 11394460,
"videoCount": 15,
"discussionVideoCount": 1,
"eventTime": "2026-08-27T00:00:00.000Z",
"searchUrl": "https://www.douyin.com/search/Example%20trending%20topic"
}
Working with snapshots
Each run represents the current board at capture time. Schedule repeated runs when you need a timeline, then compare rank, hotValue, and eventTime across exported datasets. Keep board in downstream filters so rising topics remain distinct from the ranked hot list.
Tips and limits
- Poll on a schedule if you need snapshots over time; this Actor returns the current public board, not historical rankings.
- A topic may have missing optional metrics or badge data when Douyin does not provide them.
- The Actor returns the verified public main hot list and its embedded rising strip; it does not offer account-only boards.
- Source ordering and values can change between runs as the public board refreshes.
API usage
Node.js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/douyin-hot-search-scraper').call({ maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
Python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("fetch_cat/douyin-hot-search-scraper").call(run_input={"maxItems": 20})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)
cURL
curl -X POST "https://api.apify.com/v2/acts/fetch_cat~douyin-hot-search-scraper/runs?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"maxItems":20,"includeRisingTopics":true}'
MCP
Add the Actor to an MCP-enabled client:
claude mcp add apify -- npx -y @apify/mcp-server
Example configuration:
{
"mcpServers": {
"apify": {
"command": "npx",
"args": ["-y", "@apify/mcp-server"],
"env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
}
}
}
Use https://mcp.apify.com?tools=fetch_cat/douyin-hot-search-scraper to scope the available tool. Example prompt: “Fetch the current Douyin hot-search topics and summarize the top ten by heat.”
Support
Open an issue on this Actor's Apify page with the input and approximate run time if a public source response changes.
