Douyin Hot Search Scraper

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.

Ready-to-run examples

Use one of these verified public examples to start with a bounded input:

• Scrape current Douyin hot-search trends
• Use Douyin hot search as an API
• Export Douyin trend data
• Monitor Douyin topic ranks and heat
• Research current Douyin topics for content planning

What you get

• The ranked Hot list (抖音热榜) topics.
• The optional real-time rising (实时上升热点) strip as a separate board value.
• 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"
}

Output fields

Field	Description
board, boardName	Main hot list or real-time rising strip.
rank, isPinned, peakRank	Current list position, pin state, and best position.
word, sentenceId, sentenceTag, groupId, wordType	Topic text and public Douyin identifiers/types.
hotValue, videoCount, discussionVideoCount, articleCount, liveRoomCount	Public trend metrics.
label, labelName, labelImageUrl	Douyin badge code, readable badge name, and image URL.
eventTime, eventTimestamp, boardActiveTime, trendingDescription	Snapshot and trend timing/context.
coverUrl, coverUrls	Public topic cover image URLs.
searchUrl, hotSpotUrl, sourceUrl	Direct public links and source metadata.
scrapedAt	ISO timestamp when this Actor captured the row.

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.

Pricing

This Actor charges once when a run starts and once per exported trending topic. Review the current Apify Pricing tab before running for your volume-tier rate.

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.”

FAQ

What data can I export with this Douyin scraper? Current hot-search topics, ranks, heat values, video counts, badges, timestamps, cover images, and public source links.

Can I run Douyin Hot Search Scraper through an API, schedule, or MCP client? Yes. Use an API client, schedule repeated snapshots, or add the scoped MCP tool.

How much does it cost to use Douyin Hot Search Scraper? It charges once when a run starts and once per exported topic. See the current Pricing tab before running.

Do I need a Douyin account? No. The Actor reads the public hot-search response.

Does it return every Douyin board? No. It returns the verified public main hot list and its embedded rising strip only.

Related Actors

• TikTok Sound Scraper
• TikTok Video Scraper
• TikTok Hashtag Scraper
• Bilibili Video Search Scraper
• Google Trends Scraper

Support

Open an issue on this Actor's Apify page with the input and approximate run time if a public source response changes.