Douyin Hot Search Scraper
Pricing
from $3.20 / 1,000 results
Douyin Hot Search Scraper
Collect Douyin's in-app hot-search board with heat value, rank position, and related video count, the music chart of hot, rising, or original sounds, and the ranked brand board by category. Every row carries the term, score, and rank. Built for daily Douyin trend monitoring.
Pricing
from $3.20 / 1,000 results
Rating
0.0
(0)
Developer
ToolzerHub
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Collect Douyin's in-app hot-search board, the music chart of hot, rising, or original sounds, and the ranked brand board by category. Every hot-search row carries the term, heat value, and rank; every mode is a live in-app read, not the separate hot.douyin.com dashboard. Pick a mode with scraperType.
Modes
scraperType | Returns | Needs |
|---|---|---|
hotSearch (default) | Trending search terms with heat value, rank, and related video count | — |
musicChart | Douyin's music chart, paginated | — |
brandBoard | Ranked brands in one category | category_id, or leave empty for the first category |
brandCategories | The categories the brand board is filed under | — |
Input
| Field | Use it for |
|---|---|
board_type | hotSearch only: 0 Main hot-search board (default), 2 Sub-board. |
board_sub_type | hotSearch only, used together with board_type 2 to pick which sub-board. |
chart_type | musicChart only: hot (default), rise, or original. Anything else is rejected. |
category_id | brandBoard only. From brandCategories. Left empty, the Actor fetches the category list itself and uses the first one. |
maxItems | Caps hotSearch, musicChart, and brandBoard. Default 100. Set 0 for no limit. |
{"scraperType": "hotSearch","board_type": "2"}
How many terms the board returns
hotSearch returns the full board — around 50 terms on either board_type, ranked by heat. Douyin also publishes a much shorter rising strip of about 5 terms alongside it; the Actor only falls back to that strip on the rare response where the main board comes back empty, so a run that returns a handful of rows means Douyin served no board at that moment, not that a setting is wrong.
Output
| Field | Mode | Contents |
|---|---|---|
word, hot_value, position, event_time, video_count, group_id, room_count, view_count, source_board_type | hotSearch | Each trending term |
music_info, source_chart_type | musicChart | Each charted sound |
id, name, heat, rank, is_in_webcasting, bluev_uid, bluev_sec_uid, logo_url, source_category_id | brandBoard | Each ranked brand |
id, name | brandCategories | Each brand category |
{"word": "秋天的第一杯奶茶","hot_value": 8452130,"position": 3,"video_count": 61204,"source_board_type": "2"}
Questions
Why did hotSearch only return a handful of rows?
Because board_type was left at its default. See the note above — 0 returns the small rising strip, 2 returns the full board.
Why does brandBoard work without setting category_id?
When category_id is empty, the Actor makes one extra request to list the brand categories and defaults to the first one it gets back, rather than failing the run. Run brandCategories first if you want a specific category instead of whichever one is first.
Can I filter the music chart to a specific artist or title?
No. chart_type only switches between the hot, rising, and original lists; there's no keyword filter on this endpoint. Filter the returned rows yourself after the run.
Related Actors
| Actor | Purpose |
|---|---|
| Douyin Sound Scraper | Found a sound on the music chart? Get its full detail and every video using it |
| Douyin Trending Scraper | The broader hot.douyin.com dashboard — trending topics, videos, and searches with weekly and monthly windows |
| Douyin Marketing Calendar Scraper | Plan content around what's trending, against Douyin's own campaign calendar |