Douyin Hot Search List Scraper

EN — Get the current Douyin hot search list across 5 boards. 5 boards supported: 热点榜 (default) / 种草榜 / 娱乐榜 / 社会榜 / 挑战榜. Each item includes rank, keyword (word), live heat score (hot_value), cover image, video count, and metadata. One run = one board snapshot.

ZH — 抖音热搜榜 — 当前 5 大榜单一键抓取。 支持 5 种榜单:热点榜(默认)/ 种草榜 / 娱乐榜 / 社会榜 / 挑战榜。每条含排名、关键词、热度值、封面、视频数、关联事件。一次运行 = 一个榜单快照。

Built for trend monitoring, public sentiment analysis, competitive intel, brand monitoring, and editorial planning on Douyin — China's #1 short-video platform.

5 free runs / day. No API key required — the Actor's built-in upstream key is already configured.

Input

Field	Type	Required	Default	Notes
boardType	string	no	"0"	Main board. "0" = 热点榜 (top hot), "2" = sub-boards.
boardSubType	string	no	""	Sub-board when boardType="2". One of "", "seeding", "2", "4", "hotspot_challenge". Ignored when boardType="0".

Valid boardType × boardSubType combinations

boardType	boardSubType	Board	中文
"0"	""	Top Hot	热点榜
"2"	""	Seeding	种草榜
"2"	"seeding"	Seeding (alias)	种草榜
"2"	"2"	Entertainment	娱乐榜
"2"	"4"	Social	社会榜
"2"	"hotspot_challenge"	Challenge	挑战榜

{
  "boardType": "0",
  "boardSubType": ""
}

Output

The Actor pushes one item per trending keyword to the default dataset and writes a SUMMARY record.

{
  "rank": 1,
  "word": "黄子韬在王者万象棋现场帅回来了",
  "hot_value": 9876543,
  "group_id": "7683501648006239497",
  "sentence_id": "2644651",
  "video_count": 3,
  "discuss_video_count": 1,
  "event_time": 1789096413,
  "cover_url": "https://p11-sign.douyinpic.com/cover1.jpeg",
  "hotlist_param": "{\"board_type\":3,\"rank\":0}",
  "rawData": { /* full upstream trending_list item */ }
}

SUMMARY record:

{
  "ok": true,
  "boardType": "0",
  "boardSubType": "",
  "boardLabel": "热点榜",
  "activeTime": "2026-09-10 22:30",
  "requests": 1,
  "uniqueItems": 5,
  "note": "1 Run = 1 upstream request. Pass boardType=2 + boardSubType to switch between 5 boards."
}

Use it together with the other Douyin Actors

This Actor is part of the 5-Actor Douyin MVP set. Use it together with:

Where in the pipeline	Actor	Use it to
you are here	Douyin Hot Search List Scraper (you are here)	(this Actor)
hashtag pipeline — before / step ①	../douyin-hashtag-search/README.md	if a trending word looks interesting, search it as a keyword to get the ch_id for the full pipeline
hashtag pipeline — step ②	../douyin-hashtag-detail/README.md	follow up on a discovered topic with rich ch_info
hashtag pipeline — step ③	../douyin-hashtag-video-list/README.md	walk the full video list of the discovered topic
sister Actor	../douyin-live-hot-search-list/README.md	compare mainstream vs LIVE trends — live often leads mainstream by 30-90 min

You are here: Douyin Hot Search List Scraper — run this on its own for the upstream use case described above, or chain it with the other 4 Actors for a full Douyin keyword → hashtag → videos → trends pipeline.

Use cases

Persona	Use it for
Trend researcher	Snapshot the top 50-100 hot keywords across 5 boards for a daily digest
Brand manager	Track whether your brand / campaign is climbing the 热点榜
Public sentiment analyst	Sample keywords from 社会榜 + 娱乐榜 to gauge mood
Editorial planner	Surface trending topics for content ideation
Competitive intel	Compare board coverage between rivals in the same vertical

Why this Actor exists

Douyin's hot search boards drive 90%+ of organic discovery on the platform. Brands, creators, and agencies that miss the early signal spend 3-5x more to catch up later. This Actor is the step ③ of the 4-Actor Douyin MVP set — perfect for daily trend dashboards and monitoring.

Pricing

Free users are limited to 5 runs per day. Paid users (APIFY_USER_IS_PAYING=1) have unlimited runs. The Actor itself adds no markup — you pay the upstream provider per request plus the standard Apify compute unit cost.

Test locally

cd douyin-hot-search-list
UPSTREAM_API_KEY=... UPSTREAM_BASE_URL=<your-upstream-base-url> npm test

• node test/unit.js — 6 unit assertions on normalize / extract / board-label lookup.
• node test/integration.js — 1 live call against 热点榜 (boardType=0, boardSubType="").

Output schema

See .actor/output_schema.json for the full type schema, or read it at runtime via the Apify API.

License

MIT