Douyin Extended boards API
All board entries carry board (the board option name) and rank; most also carry createdAt (publish or creation time).
Douyin trend boards: videos, topics, events, brands (boardVideo, boardTopic, boardHotspot, boardWord, boardAccount, boardEvent, boardMusic, boardBrand, boardProp, boardEventDetail, boardWordDetail, boardWordVideo, boardRelatedWord)
All board entries carry board (the board option name) and rank; most also carry createdAt (publish or creation time).
boardVideoaddsawemeId,description,playCount(plays),likeCount,likeRate(likes per play),followerGain(followers the video brought in),followRate(followers gained per play),score(board heat score),authorNickname,authorAvatar,authorFollowerCount,durationSeconds,coverUrlandurl. It has no heat history. BoardslowFanHits,highCompletion,highLikesandfollowerGrowthuse this record.boardTopicaddschallengeId(hashtag ID; pass it to modehashtag),word,hotValue,viewCount,videoCount,avgViewCount(average views per video under the topic) and a dailytrendas{date, value}.boardHotspotaddsword,hotValue,rankChange(rank movement since the previous snapshot),videoCount,category(Douyin's tag for the hot spot),sentenceId,cityCodeand an hourlytrendas{time, hotValue}. BoardschallengesandhotTotaluse this record too.boardWord(boardssearchRanking,risingSearches,hotWords) addsword,wordId,hotValue,urland a dailytrend.boardAccount(boardhotAccounts) addssecUid,nickname,followerCount,likedCount,videoCount,followerGain,newLikeCount,followRateand atrend.boardEvent(boardevents) addseventId,word,category,startDate,endDate,coverUrl.boardEventDetail(boardeventDetail, one record per ID ineventIds; take the IDs fromboardEventrows) addseventId,word,category,eventCity,startDate,endDate,publishStartDate,publishEndDate(the window in which videos count),activityDescription,reward,publishCount(videos published for the activity so far),relatedTopics,challenges({challengeId, name}; pass achallengeIdto modehashtag) andexampleVideos({awemeId, url, description, createdAt, coverUrl}). An ID the calendar does not know returns nothing.- Hot word detail (board
hotWordDetail, one lookup per ID inwordIds; take the IDs fromboardWordrows of boardhotWords) returns, for each word, oneboardWordDetailrecord (word,wordId,hotValue,url, dailytrendof the word's heat, dailycontentTrend,commentTrend,likeTrend,shareTrend, andwindows: totals for the last 1, 7, 30 and 60 days) followed by up to 30boardWordVideorows (awemeId,url,description,createdAt,durationSeconds,coverUrl,likeCount,commentCount,shareCount,authorNickname,authorAvatar) and up to 9boardRelatedWordrows (word,wordId,hotValue,url,trend). Rows carryrelatedToandrelatedToId(the word they belong to). A word ID is only valid for about a day after its board entry, so use a fresh one: an old or unknown ID returns nothing. - Creator-center boards (the lists Douyin's creator center shows creators; one list per run, no paging):
creatorHotSpotsreturnsboardHotspot(word,hotValue,rankChange,category,queryId,coverUrl,url;hotSpotRankingoverall, local or rising);creatorTopicsreturnsboardTopic(word,queryId,playCount,likeCount,commentCount,shareCount,videoCount,publisherCount,coverUrl);creatorMusicreturnsboardMusic(musicTitle,queryId,hotValue,playCount,likeCount,commentCount,shareCount,videoCount);creatorPropsreturnsboardProp(word,queryId,playCount,videoCount,shootCount,exposureCount,collectCount,likeCount);creatorVideosreturnsboardVideo(awemeId,url,description,hotValue,playCount,likeCount,commentCount,shareCount,durationSeconds,authorNickname).queryIdis the board's own ID, not a Douyin hashtag or sound ID. Topic, sound and prop entries carry nourl, hashtag ID or sound ID. A heat value of 0 from Douyin is returned as null. - DOU+ boards:
douplusVideosreturnsboardVideofor the ranking period (playCount,likeCount,likeRate,followerGain,followRate,completionRate(share watched to the end),score(popularity index),createdAt,authorNickname,authorFollowerCount);douplusTalentsreturnsboardAccount(secUid,url,nickname,douyinId,followerCount,avatarUrl) for one creator category. boardMusic(boardmusicChart) has the sound fields plushotValue;boardBrand(boardbrandChart) addsbrandId,word,hotValue,heatChange,rankChange,secUid.
The input that produced this run
Mode board. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "board" | What to scrape: the hot search board, videos (or image posts) by keyword, a creator's videos, details of videos, creator profiles, comments (optionally with replies) of videos, danmaku of videos, the videos of a... |
board | "eventDetail" | Which board to read. Videos: hot videos, low-fan hits, high completion, high likes, follower growth. Topics: hot and rising topics, challenges. Hot spots: rising, city, overall (needs dateFrom/dateTo, default the last... |
eventIds | ["2000"] | IDs of events of the events calendar (the eventId of a boardEvent row). Each event is one record. Every event after the first also pays one run-start fee. |
maxResults | 1 | Maximum number of items to return in total for this run. You are charged per item returned. |
17 fields in every boardEventDetail
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | boardEventDetail |
board | str | eventDetail |
eventId | str | 2000 |
word | str | 全国年味巡游开始啦 |
category | str | 话题互动 |
eventCity | null | null |
coverUrl | str | http://p6-dyhot.byteimg.com/tos-cn-i-jid1fmi4d3/93c6a5aa2... |
startDate | str | 2026-01-29T16:00:00Z |
endDate | str | 2026-02-24T15:59:59Z |
publishStartDate | str | 2026-01-30T12:00:00+08:00 |
publishEndDate | str | 2026-02-24T12:00:00+08:00 |
activityDescription | str | 年味在哪?上抖音过春节,吃喝玩乐寻年味,2月10日至2月23日,吃喝玩乐好货福利拉满,快来晒出你的过年新生活,跟着... |
reward | null | null |
publishCount | int | 8332 |
relatedTopics | list | ["全国年味巡游开始啦"] |
challenges | list | [{"challengeId": "7600748480302155776", "name": "全国年味巡游开始啦"} |
exampleVideos | list | [{"awemeId": "7600260688858102203", "url": "https://www.douy |
A real run, 17 fields per record
Run on 2026-11-09 with input {"mode": "board", "board": "eventDetail", "eventIds": ["2000"], "maxResults": 1}. Personal fields of ordinary users are masked here.
| word | activityDescription | board | category | startDate | endDate |
|---|---|---|---|---|---|
| 全国年味巡游开始啦 | 年味在哪?上抖音过春节,吃喝玩乐寻年味,2月10日至2月23日,吃喝玩乐好货福利拉满,快来晒出你的过年新生活,跟着... | eventDetail | 话题互动 | 2026-01-29T16:00:00Z | 2026-02-24T15:59:59Z |
All 17 fields in one record
typeboardEventDetailboardeventDetaileventId2000word全国年味巡游开始啦category话题互动eventCitycoverUrlhttp://p6-dyhot.byteimg.com/tos-cn-i-jid1fmi4d3/93c6a5aa2...startDate2026-01-29T16:00:00ZendDate2026-02-24T15:59:59ZpublishStartDate2026-01-30T12:00:00+08:00publishEndDate2026-02-24T12:00:00+08:00activityDescription年味在哪?上抖音过春节,吃喝玩乐寻年味,2月10日至2月23日,吃喝玩乐好货福利拉满,快来晒出你的过年新生活,跟着...rewardpublishCount8332relatedTopicschallengesexampleVideos
What one boardEventDetail costs
result · Each video, comment (and reply), hot topic, follower or following entry, creator, hashtag, sound, series or board entry returned (the detail boards eventDetail and hotWordDetail: each record or row, and each ID after the first also pays one run-start fee) · $0.005 · $0.004511 · $0.004076
Run this request yourself
The same input as above, three ways.