Douyin Hot Board Scraper — Trending Topics & Heat

What does Douyin Hot Board Scraper do?

Douyin Hot Board Scraper extracts the live Douyin hot board (抖音热榜), the real-time rising topics and Douyin's entertainment, society, challenge and seeding boards from douyin.com as structured JSON. Each trending topic carries its board rank, Douyin's trending heat score, view count and video count, plus the hot label, peak rank, topic links and cover images. Pick a board, set a result limit, and run it on a schedule to follow what is trending over time.

How to use this actor

• 👉 Register for a free Apify account — no credit card required.
• 🎉 Just click Sign up free on Apify → and complete a quick signup.
• 💰 A free Apify account includes $5 in monthly credits — enough to test this actor.
• ⏳ Scrape during the free trial, with no commitment or upfront payment required.

Key features

• 🔥 Hot board and rising topics: pick the main hot board (抖音热榜) or the real-time rising topics with query; each topic carries its rank, board, label and peakRank.
• 📈 Heat score and engagement counts: hotValue (also heat), viewCount, videoCount, discussionVideoCount, articleCount and liveRoomCount show how big each topic is.
• 🔗 Topic links and covers: searchUrl, hotSpotUrl, coverUrl and coverUrls link each topic to its Douyin pages and cover images.
• 🕒 Board snapshot time: boardActiveTime (Beijing time) and boardActiveTimeUtc say which snapshot of the board you got; eventTime is when the topic started.
• 🔗 Paste-mode: paste the https://www.douyin.com/hot URL into startUrls to load the hot board.
• ♻️ Incremental mode: recurring runs emit and charge only for listings that are new or whose tracked content changed. First run builds the baseline; subsequent runs emit only NEW / UPDATED / REAPPEARED records (UNCHANGED + EXPIRED opt-in). Saves 80–95% on daily monitoring.
• 🔔 Notifications: Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue.
• 📦 Compact mode: AI-agent and MCP-friendly payloads with core fields only.
• 🔌 MCP connectors: export your results into Notion via Apify's MCP connectors — a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows.
• 📌 Change classification: each record carries a changeType of NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Default emits NEW + UPDATED + REAPPEARED; opt into the others with emitUnchanged / emitExpired.
• 🧹 Empty-field stripping: drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards that already handle missing fields gracefully.

What data can you extract from douyin.com?

Each result includes Core trend fields (board, boardName, rank, isPinned, word, hotValue, viewCount, and videoCount, and more) and extended fields (detailFetched). In standard mode, all fields are always present — unavailable data points are returned as null, never omitted. In compact mode, only core fields are returned.

Input

The main inputs are a query choice (hot / rising / entertainment / society / challenge / seeding) and a result limit. Additional filters and options are available in the input schema.

Key parameters:

• query — Which board to scrape: the main hot board (抖音热榜), the real-time rising topics (实时上升热点), or one of Douyin's sub-boards — entertainment (娱乐榜), society (社会榜), challenge (挑战榜) or seeding (种草榜). To get several boards in one run, pick them under 📋 Boards instead. (default: "hot")
• boards — Optional. Pick several boards to scrape them all in one run (each topic carries its board). When set, this replaces the single 📈 Board above.
• maxResults — Maximum total trending topics (0 = unlimited). The hot board returns up to ~50 topics per snapshot, the rising board ~5; fewer are delivered when the board is smaller. (default: 100)
• compact — Core fields only (for AI-agent/MCP workflows). (default: false)
• excludeEmptyFields — Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards. (default: false)
• incrementalMode — Compare against previous run state. stateKey is optional — defaults to a value derived from the selected board(s) so different boards never share state. (default: false)
• stateKey — Optional. Stable identifier for the tracked board universe. Leave empty to auto-generate from the board selection.
• skipReposts — When incremental, skip topics whose content matches a topic that dropped off the board in a prior run (cross-run duplicate detection). (default: false)
• emitUnchanged — When incremental mode is on, also emit topics whose rank, heat and counts have not changed since the last run. (default: false)
• emitExpired — When incremental mode is on, also emit topics that were seen before but are no longer on the board. (default: false)
• notifyOnlyChanges — When Incremental Mode is on, only send notifications for NEW and UPDATED topics. Has no effect outside incremental mode. (default: false)
• notificationLimit — Maximum number of topics included in each notification message (1–20). (default: 5)
• ...and 13 more parameters

Input examples

Main hot board — The current Douyin hot board (抖音热榜), up to 50 topics.

→ One row per trending topic with rank, heat score, view count, video count, label and links.

{
  "query": "hot",
  "maxResults": 50
}

Rising topics — The real-time rising topics board (实时上升热点).

→ The rising topics with their label and links; rising topics have no board rank.

{
  "query": "rising"
}

Several boards in one run — Scrape the hot board and the entertainment and society boards together.

→ One row per topic per board; each row carries its board and its rank on that board.

{
  "boards": [
    "hot",
    "entertainment",
    "society"
  ]
}

Paste the hot board URL — Load the hot board from its page URL instead of picking a board.

→ The same rows as the main hot board.

{
  "startUrls": [
    "https://www.douyin.com/hot"
  ]
}

Track new and changed topics — Run on a schedule with a fixed stateKey to get only topics that are new or changed since the last run.

→ Topics with changeType NEW or UPDATED; unchanged topics are left out.

{
  "query": "hot",
  "incrementalMode": true,
  "stateKey": "douyin-hot-board"
}

Output

Each run produces a dataset of structured trend records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

Example trend record

{
  "board": "hot",
  "boardName": "Douyin Hot List (抖音热榜)",
  "isPinned": true,
  "word": "全面从严治党为什么要一抓到底",
  "hotValue": 0,
  "viewCount": 0,
  "videoCount": 0,
  "discussionVideoCount": 1,
  "articleCount": 0,
  "liveRoomCount": 0,
  "label": 0,
  "sentenceId": "2716539",
  "searchUrl": "https://www.douyin.com/search/%E5%85%A8%E9%9D%A2%E4%BB%8E%E4%B8%A5%E6%B2%BB%E5%85%9A%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E4%B8%80%E6%8A%93%E5%88%B0%E5%BA%95",
  "hotSpotUrl": "https://www.douyin.com/hot/2716539/%E5%85%A8%E9%9D%A2%E4%BB%8E%E4%B8%A5%E6%B2%BB%E5%85%9A%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E4%B8%80%E6%8A%93%E5%88%B0%E5%BA%95",
  "boardActiveTime": "2026-10-28 09:01:32",
  "scrapedAt": "2026-10-28T01:02:54.037Z",
  "title": "全面从严治党为什么要一抓到底",
  "type": "trend",
  "platform": "douyin",
  "platformName": "Douyin 抖音",
  "heat": 0,
  "wordType": 14,
  "url": "https://www.douyin.com/search/%E5%85%A8%E9%9D%A2%E4%BB%8E%E4%B8%A5%E6%B2%BB%E5%85%9A%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E4%B8%80%E6%8A%93%E5%88%B0%E5%BA%95",
  "portalUrl": "https://www.douyin.com/search/%E5%85%A8%E9%9D%A2%E4%BB%8E%E4%B8%A5%E6%B2%BB%E5%85%9A%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E4%B8%80%E6%8A%93%E5%88%B0%E5%BA%95",
  "boardActiveTimeUtc": "2026-10-28T01:01:32.000Z",
  "listingId": "237eb0f836449e75c8780e05277c1884b893a7993efb3edc8856efce730187c1",
  "listingKey": "hot:2716539",
  "searchQuery": "hot",
  "contentQuality": "full",
  "detailFetched": false,
  "source": "douyin.com",
  "contentHash": "9a469cec17d346c9664a3b8cc9810d090110c6846c11f8415c7d8af654ab5840"
}

Incremental fields

When incremental mode is on, each record also carries:

• changeType — one of NEW, UPDATED, UNCHANGED, REAPPEARED, EXPIRED. Default output covers NEW / UPDATED / REAPPEARED; set emitUnchanged: true or emitExpired: true to opt into the others.
• isRepost, repostOfId, repostDetectedAt — populated when a new listing matches the tracked content of a previously expired one. Set skipReposts: true to drop detected reposts from the output.

How to scrape douyin.com

1. Go to Douyin Hot Board Scraper in Apify Console.
2. Pick a board in query: the main hot board (hot), the rising topics (rising) or a sub-board (entertainment, society, challenge, seeding). To scrape several boards in one run, list them in boards.
3. Set maxResults to control how many topics you need.
4. Click Start and wait for the run to finish.
5. Export the dataset as JSON, CSV, or Excel.

Use cases

• Extract trend data from douyin.com for market research and competitive analysis.
• Monitor new and changed trends on scheduled runs without processing the full dataset every time.
• Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode.
• Export clean, structured data to dashboards, spreadsheets, or data warehouses.

How much does it cost to scrape douyin.com?

Pricing for Douyin Hot Board Scraper has not been finalized yet. It will be published here before the actor becomes publicly available.

You only use your normal Apify platform resources when you run the actor from your own account.

FAQ

How many results can I get from douyin.com?

The number of results depends on the search query and available trends on douyin.com. Use the maxResults parameter to control how many results are returned per run.

Does Douyin Hot Board Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed trends on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset.

Can I integrate Douyin Hot Board Scraper with other apps?

Yes. Douyin Hot Board Scraper works with Apify's integrations to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

Can I use Douyin Hot Board Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the Apify API. Client libraries are available for JavaScript, Python, and other languages.

Can I use Douyin Hot Board Scraper through an MCP Server?

Yes. Apify provides an MCP Server that lets AI assistants and agents call this actor directly. Use compact mode, a single descriptionFormat, and excludeEmptyFields to keep payloads manageable for LLM context windows.

Is it legal to scrape douyin.com?

This actor extracts publicly available data from douyin.com. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

Your feedback

If you have questions, need a feature, or found a bug, please open an issue on the actor's page in Apify Console. Your feedback helps us improve.

You might also like

• Loom Video Scraper — Transcripts & Metadata — Scrape Loom videos from share or embed URLs or from 32-character video IDs. Every row carries the.
• Pexels Scraper — Photos, Videos & Engagement Data — This Pexels scraper extracts photos and videos by search, curated feed, photo ID, user, collection.
• Snapchat Profile Scraper [Just 💰$0.03] — Scrape Snapchat public profiles of creators and brands by keyword or profile URL. Each row has.
• Video & Audio Transcriber · Whisper Speech-to-Text, SRT & VTT — Whisper speech-to-text for any video, audio or podcast URL: full transcript with timestamped.
• YouTube Comment Scraper — Comments, Replies, Likes — Scrape YouTube comments and their reply threads from any video, channel, or search query. Each.
• YouTube Scraper $2/1K — Videos, Channels, Comments, Transcripts — Scrape YouTube videos, channels, comments, and transcripts in one tool — by keyword or by video,.
• Bluesky Scraper - Posts, Search and Profile Feeds — Scrape Bluesky posts by keyword search, @handle or profile URL. Each post includes its full text.
• Facebook Ad Library Scraper [💰$0.05/1k] — Ads & EU Reach — Scrape facebook.com/ads/library by keyword or advertiser: ad copy, image and video URLs, landing.

Getting started with Apify

New to Apify? Create a free account with $5 credit — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click Start — export results as JSON, CSV, or Excel

Need more later? See Apify pricing.

Disclaimer

This actor accesses only publicly available data on douyin.com. You are responsible for how you use the extracted data — in particular any personal information such as names, phone numbers, or email addresses — and for complying with Douyin Hot Board's terms of use, applicable data-protection law (including the GDPR where it applies), and the anti-spam rules of your jurisdiction.

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Douyin Hot Board or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

Search keywords

douyin scraper, douyin api, apify douyin, douyin data extraction, douyin hot board scraper, douyin hot board api, apify douyin hot board, douyin hot board data extraction, douyin.com scraper, douyin.com data, douyin.com api, social media scraper, video data, creator data.