Douyin Hot Search Scraper - Real-Time Trending Topics
Pricing
from $5.99 / 1,000 results
Douyin Hot Search Scraper - Real-Time Trending Topics
Scrape Douyin (抖音) real-time trending topics across all 5 hot-search boards. Get rank, hot value, view count, video count, cover image, and event time for every topic. No login or setup needed. Export to JSON, CSV, or Excel.
Pricing
from $5.99 / 1,000 results
Rating
0.0
(0)
Developer
Zen Studio
Maintained by CommunityActor stats
4
Bookmarked
986
Total users
160
Monthly active users
2 days ago
Last modified
Categories
Share
Douyin Hot Search Scraper (抖音热榜) | Real-Time Trending Topics, Hashtags & Rankings (2026)
From Zen Studio, creators of Douyin Search and RedNote Search. Together, those two actors have served 100,000+ runs and have ranked #1 for their respective source keywords in Apify Store relevance results.
Why choose this actor?
- Follow five sides of Douyin's conversation. Collect Hot Search, product recommendations, entertainment, news and society, and hashtag challenges into one dataset. Repeated topics across boards are deduplicated.
- Measure attention, not just a topic's name. Get its rank, heat score, views and video count to prioritize what deserves a closer look.
- Track how topics move. Trend timestamps, board update times and collection timestamps make scheduled snapshots useful for monitoring changing ranks and attention.
Try five topics per board
{"boards": ["hotspot", "seeding", "entertainment", "social", "challenge"],"maxResultsPerBoard": 5}
Open actor input, paste the example and start a run. Export the results as JSON, CSV or Excel. All five boards require a paid Apify plan. Free-plan access is limited to the first selected board and 15 lifetime runs. See the Pricing tab for current charges.
Douyin usually exposes around 50 topics per board. The example requests up to five from each; cross-board duplicates are returned once. Some pinned topics have no engagement counts, which remain empty instead of being reported as zero.
| Zen Studio · Douyin Suite | ||||
You are here | Videos by keyword | Creators & posts | Comments & replies | Details & downloads |
Copy to your AI assistant
zen-studio/douyin-hot-search-scraper on Apify. Scrapes Douyin's (抖音) real-time trending topics across five boards: hot search, entertainment, social, seeding, and challenge. Call ApifyClient("TOKEN").actor("zen-studio/douyin-hot-search-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Full spec: GET https://api.apify.com/v2/acts/zen-studio~douyin-hot-search-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
What you get
Up to ~50 trending topics per board, each with rank, hot value, view count, video count, cover image, badge, and when the topic started trending. Five boards to choose from, scraped live in seconds.
Boards
- Hot Search (热点榜): the main real-time trending list
- Seeding (种草榜): product / recommendation trends
- Entertainment (娱乐榜): celebrity and entertainment trends
- Social (社会榜): news and society trends
- Challenge (挑战榜): trending hashtag challenges
How to Get Douyin Trending Topics
Basic: the main hot-search board
{"boards": ["hotspot"],"maxResultsPerBoard": 50}
Track news + society trends together
{"boards": ["hotspot", "social"],"maxResultsPerBoard": 50}
Every board in one run
{"boards": ["hotspot", "seeding", "entertainment", "social", "challenge"],"maxResultsPerBoard": 50}
Input Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
boards | string[] | ["hotspot"] | Which boards to scrape. Any of hotspot / seeding / entertainment / social / challenge. Pick one or several. |
maxResultsPerBoard | integer | 50 | How many topics to return per board (1–60). Douyin makes ~50 available per board, so higher values simply return everything on the board. |
What Data Can You Extract from Douyin Hot Search?
One row per trending topic. Each row carries 31 fields covering ranking (rank, position, maxRank), engagement (hotValue, viewCount, videoCount, discussVideoCount), the cover image (coverImageUrl plus the full wordCover object with every mirror URL), the topic badge (labelUrl), timing (eventTime, boardActiveTime, scrapedAt), Douyin IDs (sentenceId, groupId), category codes (wordType, label, sentenceTag, displayStyle), and sparse passthroughs (postAwemeInfo, wordSubBoard, topicInfo, roomCount, hotlistParam).
Output Example
A real row, shown in full. Sparse fields come back as null so the shape stays consistent across every topic.
{"type": "trending","board": "hotspot","listType": "board","rank": 25,"position": 24,"maxRank": 24,"word": "你真的自由了","hotValue": 8387467,"viewCount": 31839695,"videoCount": 10,"discussVideoCount": 1,"articleDetailCount": 0,"coverImageUrl": "https://p9-sign.douyinpic.com/tos-cn-i-0813/oED1ACAaQC1GYIEC7f9AAXjAzHfoogSmADAAFq~noop.jpeg?lk3s=bfd515bb&x-expires=1780362000&x-signature=Uu1Roin4sExdXHbenKbtgnljiUM%3D&from=3218412987","wordCover": {"uri": "tos-cn-i-0813/oED1ACAaQC1GYIEC7f9AAXjAzHfoogSmADAAFq","url_list": ["https://p9-sign.douyinpic.com/tos-cn-i-0813/oED1ACAaQC1GYIEC7f9AAXjAzHfoogSmADAAFq~noop.jpeg?lk3s=bfd515bb&x-expires=1780362000&x-signature=Uu1Roin4sExdXHbenKbtgnljiUM%3D&from=3218412987","https://p26-sign.douyinpic.com/tos-cn-i-0813/oED1ACAaQC1GYIEC7f9AAXjAzHfoogSmADAAFq~noop.jpeg?lk3s=bfd515bb&x-expires=1780362000&x-signature=UHB%2FxFTiF0EJiun%2F4%2F%2F%2BHxVZLe8%3D&from=3218412987","https://p3-sign.douyinpic.com/tos-cn-i-0813/oED1ACAaQC1GYIEC7f9AAXjAzHfoogSmADAAFq~noop.jpeg?lk3s=bfd515bb&x-expires=1780362000&x-signature=%2FZO5wkJPwrMBlqgQVf27CVc6DEI%3D&from=3218412987"]},"labelUrl": "https://lf3-static.bytednsdoc.com/obj/eden-cn/vjl_avo_upfbvk/ljhwZthlaukjlkulzlp/hotspot_detail_page/9.png","eventTime": "2026-06-01T13:46:28.000Z","boardActiveTime": "2026-06-02 03:31:14","sentenceId": "2520435","groupId": "6655587063489893635","wordType": 1,"label": 9,"sentenceTag": 1002,"displayStyle": 0,"canExtendDetail": false,"hotlistParam": { "version": 1 },"postAwemeInfo": {"music_id": "7097660854023260964","most_used_music_id_map": {"1128": "7097660854023260964","2329": "7097660854023260964","8663": "7097660854023260964"}},"wordSubBoard": [3],"topicInfo": null,"roomCount": null,"isPinned": false,"scrapedAt": "2026-06-01T19:32:07.000Z"}
Advanced Usage
Daily trend tracking
Schedule a run once or twice a day and store each dataset. The eventTime, hotValue, and maxRank fields let you chart how a topic climbs and fades over time, and boardActiveTime tells you exactly when Douyin last refreshed the ranking.
Read Chinese trends in English
Feed word through a translation step to turn the trending phrases into English in your own pipeline; useful for newsrooms, trend reports, and social listening dashboards.
Pull the videos behind a trend
Take any word and pass it to the Douyin Search Scraper to fetch the actual videos driving the topic, with full metadata, creator profiles, and engagement stats.
Pricing: Pay Per Event (PPE)
$7.99 per 1,000 results. Each trending topic written to the dataset counts as one result. Cross-board duplicates are billed only once, and there is no charge for a board that fails to load.
| Event | Per call | Per 1,000 |
|---|---|---|
result (one trending topic row) | $0.00799 | $7.99 |
Free tier
15 lifetime runs, limited to the first selected board (~50 topics per run). No credit card. Plenty to evaluate the data shape before upgrading for all five boards.
FAQ
What is Douyin (抖音)? Douyin is ByteDance's Chinese short-video platform, the counterpart of TikTok for the Chinese market. Its trending boards (热榜) are the closest thing China has to a real-time pulse of what the country is watching and talking about.
How many topics are returned per board?
Around 50; that's how many Douyin publishes per board. Set maxResultsPerBoard lower to cap it, or up to 60 to take everything the board offers.
How fresh is the data?
Live: every board is fetched on demand at run time. The boardActiveTime field records exactly when Douyin last refreshed that ranking.
Can I scrape all five boards in one run?
Yes. List them in boards and each is fetched and returned in the same run. A topic that appears on more than one board is returned once and billed once.
What's the difference between rank, position, and maxRank?
rank is the topic's 1-based position within the board as returned in this run. position is the server-reported rank, and maxRank is the highest (best) rank the topic has reached during its run on the board.
Why does the top row sometimes have no hot value or view count?
The very first row is often Douyin's hand-pinned headline slot, flagged with isPinned: true. Douyin promotes it editorially rather than by engagement, so it carries no hotValue / viewCount / videoCount; those fields come back as null. Every other row is ranked by hot value and has full metrics. Filter on isPinned: false if you only want the algorithmically-ranked topics.
Are the cover image URLs permanent?
The cover and badge image URLs are signed and stay valid for roughly two weeks. If you need them long-term, download the bytes from coverImageUrl (or any URL in wordCover.url_list) into your own storage shortly after the run.
Do I need a proxy or login? No. The boards are public and load from any region without an account. A proxy is optional and only needed if you want to egress from a specific country.
How do I export the trending data? The dataset downloads as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or via the Apify API. Rows are flat, so CSV and Excel work well for charting.
Is it legal to scrape Douyin's trending boards? The boards are public editorial rankings, nothing behind a login. You are responsible for complying with Douyin's terms of service and applicable regulations (GDPR, CCPA, PIPL); rows contain topic-level data, not user profiles.
Can I get the videos, profiles, or comments behind a topic?
Not in this actor; it returns the trending boards only. Pass a topic's word to Douyin Search Scraper for the videos driving it, then chain into Douyin Video Scraper, Douyin Comments Scraper, or Douyin Profile Scraper for the details.
More Zen Studio scrapers for Chinese platforms
🎬 Short-video & social
Zhihu 知乎
Weibo 微博
Kwai (Brazil)
Kuaishou 快手
Douyin 抖音
RedNote 小红书
Xigua 西瓜视频
Bilibili 哔哩哔哩
🛒 E-commerce
Naver Search 네이버 검색
Shopee
Taobao 淘宝
JD.com 京东
1688 阿里巴巴
Weidian 微店
Goofish 闲鱼
Coupang 쿠팡
🏠 Real estate & autos
Anjuke 安居客
58.com 58同城
Autohome 汽车之家
🧭 Travel & maps
Mafengwo 马蜂窝
Support
- Bugs: Issues tab
- Features: Issues tab
Legal Compliance
Extracts publicly available data from Douyin (抖音). Users must comply with Douyin's terms of service and applicable data protection regulations (GDPR, CCPA, PIPL).
Structured Douyin trending boards: rank, hot value, view count, video count, cover image, and event time. One row per topic, in clean JSON.
