Douyin V2 API
Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.
87 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Billboard
31 endpoints- Get a calendar eventReturns one event from the marketing calendar.
/v2/douyin/billboard/calendar/detail2 crGET - Get a city boardReturns the local hot board. Pass city_code from /billboard/city-codes to narrow it.
/v2/douyin/billboard/city2 crGET - Get a video audienceReturns who liked a video, broken down demographically. Board-listed videos only, inside Douyin's viewable window.
/v2/douyin/billboard/videos/audience2 crGET - Get account analysisReturns last week's posting analysis for an account.
/v2/douyin/billboard/accounts/analysis2 crGET - Get account trendsReturns an account's follower series over a lookback window.
/v2/douyin/billboard/accounts/trends2 crGET - Get an account audienceReturns the demographic breakdown of an account's followers.
/v2/douyin/billboard/accounts/audience2 crGET - Get hot-word detailsReturns the detail behind one hot content word, for a given day.
/v2/douyin/billboard/words/detail2 crGET - Get the account boardReturns the ranked hot accounts for a lookback window.
/v2/douyin/billboard/accounts2 crGET - Get the challenge boardReturns the ranked hashtag challenges.
/v2/douyin/billboard/challenges2 crGET - Get the hot boardReturns hot.douyin.com's main board, either as a point-in-time snapshot or aggregated over a date range.
/v2/douyin/billboard/hot2 crGET - Get the rising boardReturns topics whose popularity is climbing fastest.
/v2/douyin/billboard/rising2 crGET - Get the search boardReturns the ranked search terms for a lookback window.
/v2/douyin/billboard/searches2 crGET - Get the topic boardReturns the ranked topics for a lookback window.
/v2/douyin/billboard/topics2 crGET - Get the video boardReturns the ranked hot videos for a lookback window.
/v2/douyin/billboard/videos2 crGET - Get video comment keywordsReturns the weighted comment word cloud for a video, as used by hot.douyin.com.
/v2/douyin/billboard/videos/comment-words2 crGET - Get video trendsReturns a video's metric series. Douyin serves this only for videos currently on a board and inside its viewable window; anything older returns an empty result.
/v2/douyin/billboard/videos/trends2 crGET - List audience accountsReturns up to 20 other creators this account's followers are interested in.
/v2/douyin/billboard/accounts/audience/accounts2 crGET - List audience searchesReturns up to 10 terms this account's followers searched in the last three days.
/v2/douyin/billboard/accounts/audience/searches2 crGET - List audience topicsReturns up to 10 topics this account's followers engaged with in the last three days.
/v2/douyin/billboard/accounts/audience/topics2 crGET - List board categoriesReturns the category tags for a board, for use as the tag filter elsewhere.
/v2/douyin/billboard/categories2 crGET - List calendar eventsReturns Douyin's marketing event calendar for a date range, as Unix timestamps in seconds.
/v2/douyin/billboard/calendar2 crGET - List city codesReturns the ~394 Chinese city codes accepted by the city board.
/v2/douyin/billboard/city-codes2 crGET - List content tagsReturns the vertical content tags used across the boards.
/v2/douyin/billboard/content-tags2 crGET - List high-completion-rate videosReturns videos ranked by watch-through rate.
/v2/douyin/billboard/high-completion-rate2 crGET - List high-follow-rate videosReturns videos ranked by how many followers they won.
/v2/douyin/billboard/high-follow-rate2 crGET - List high-like-rate videosReturns videos ranked by like rate rather than raw likes.
/v2/douyin/billboard/high-like-rate2 crGET - List hot wordsReturns the hot content words for a lookback window.
/v2/douyin/billboard/words2 crGET - List low-follower hitsReturns videos that went hot despite a small follower count (低粉爆款).
/v2/douyin/billboard/low-follower-hits2 crGET - List rising searchesReturns search terms whose volume is climbing fastest.
/v2/douyin/billboard/rising-searches2 crGET - List rising topicsReturns topics whose popularity is climbing fastest.
/v2/douyin/billboard/rising-topics2 crGET - Search board accountsFinds accounts by nickname or Douyin handle, returning follower, like and publish counts.
/v2/douyin/billboard/accounts/search2 crGET
Collections
4 endpoints- Get collection detailsReturns one collection (mix / 合集). Accepts a collection_id or a douyin.com/collection/ URL.
/v2/douyin/collections/detail2 crGET - Get series detailsReturns one 短剧 series by series_id.
/v2/douyin/collections/series/detail2 crGET - List collection videosReturns the videos in a collection, in episode order.
/v2/douyin/collections/videos2 crGET - List series episodesReturns the episodes of a 短剧 series.
/v2/douyin/collections/series/videos2 crGET
Feeds
8 endpoints- Get a channel feedReturns the recommendation feed for a channel tag_id.
/v2/douyin/feeds/channel2 crGET - Get the anime feedReturns Douyin's 二次元 recommendation feed.
/v2/douyin/feeds/anime2 crGET - Get the food feedReturns Douyin's food recommendation feed.
/v2/douyin/feeds/food2 crGET - Get the gaming feedReturns Douyin's gaming recommendation feed.
/v2/douyin/feeds/game2 crGET - Get the home feedReturns Douyin's guest home feed.
/v2/douyin/feeds/home2 crGET - Get the knowledge feedReturns Douyin's knowledge recommendation feed.
/v2/douyin/feeds/knowledge2 crGET - Get the music feedReturns Douyin's music recommendation feed.
/v2/douyin/feeds/music2 crGET - Get the short-drama feedReturns Douyin's 短剧 feed as card_list. Page with offset.
/v2/douyin/feeds/series2 crGET
Hashtags
2 endpoints- Get hashtag detailsReturns one hashtag (challenge). Accepts a hashtag_id or a douyin.com/hashtag/ URL.
/v2/douyin/hashtags/detail2 crGET - List hashtag videosReturns videos tagged with a hashtag. Douyin returns these under mix_list (each entry wrapping an aweme_info) as well as aweme_list, so read both.
/v2/douyin/hashtags/videos2 crGET
Live
7 endpoints- Get a gift rankingReturns the gift-giver ranking for a live room.
/v2/douyin/live/gift-ranking2 crGET - Get a live room by room IDReturns a live room by its internal room_id, which differs from the webcast id in the URL.
/v2/douyin/live/room/by-room-id2 crGET - Get a live room by userReturns the live room for a sec_user_id, including the stream URLs when the account is broadcasting.
/v2/douyin/live/room/by-user2 crGET - Get a live room by webcast IDReturns a live room by webcast_id. Accepts a live.douyin.com/ URL.
/v2/douyin/live/room/by-webcast-id2 crGET - Get live statusReturns a user's live status by numeric uid. user_live is empty when the account is not broadcasting.
/v2/douyin/live/status2 crGET - List live room productsReturns the products on sale in a live room. Requires both the room_id and the host's author_id.
/v2/douyin/live/products2 crGET - Resolve a live room IDResolves the webcast_id in a live.douyin.com URL to the room_id other live endpoints require.
/v2/douyin/live/room-id2 crGET
Music
2 endpointsProfiles
9 endpoints- Get a profileReturns one public profile. Accepts a sec_user_id or a douyin.com/user/ profile URL.
/v2/douyin/profiles/info2 crGET - Get a profile by handleReturns one public profile for a Douyin handle (抖音号).
/v2/douyin/profiles/info/by-username2 crGET - Get a profile by short IDReturns one public profile for a Douyin short_id.
/v2/douyin/profiles/info/by-short-id2 crGET - Get a profile by user IDReturns one public profile for a numeric uid, as an alternative to the sec_user_id the main profile endpoint takes.
/v2/douyin/profiles/info/by-uid2 crGET - List collection folder videosReturns the videos saved in a public 收藏夹, by collection_id.
/v2/douyin/profiles/collections/videos2 crGET - List profile seriesReturns the 短剧 series published by a profile. series_infos is null for accounts that publish none.
/v2/douyin/profiles/series2 crGET - List profile videosReturns videos posted by a profile. Page with cursor, taking the value from the previous response's max_cursor.
/v2/douyin/profiles/posts2 crGET - List publicly liked videosReturns videos a profile has publicly liked. Empty for accounts that hide their likes, which is the Douyin default.
/v2/douyin/profiles/likes2 crGET - Resolve a secure user IDResolves a numeric uid to the sec_user_id other endpoints require.
/v2/douyin/profiles/sec-user-id2 crGET
Search
12 endpoints- Get hashtag suggestionsReturns suggested hashtags for a keyword.
/v2/douyin/search/suggestions/hashtags15 crGET - Get search suggestionsReturns Douyin's autocomplete suggestions for a keyword.
/v2/douyin/search/suggestions15 crGET - Search all contentDouyin's comprehensive search: mixed videos, accounts and hashtags for a keyword. Page by sending back both cursor and search_id from the previous response.
/v2/douyin/search15 crGET - Search discussionsReturns discussion results for a keyword, inside Douyin's business_data envelope.
/v2/douyin/search/discussions15 crGET - Search experiencesReturns 经验 results for a keyword, inside Douyin's business_data envelope.
/v2/douyin/search/experiences15 crGET - Search hashtagsReturns hashtags (challenges) matching a keyword.
/v2/douyin/search/hashtags15 crGET - Search image postsReturns image/text posts matching a keyword. Records arrive inside Douyin's own business_data envelope — no unwrapped version of this endpoint exists.
/v2/douyin/search/images15 crGET - Search multiple content typesReturns Douyin's multi-type search, an array of typed result blocks.
/v2/douyin/search/multi15 crGET - Search profilesReturns accounts matching a keyword, optionally narrowed by follower band and account type.
/v2/douyin/search/users15 crGET - Search schoolsReturns schools matching a keyword, as used by Douyin's campus tagging.
/v2/douyin/search/schools15 crGET - Search soundsReturns sounds matching a keyword.
/v2/douyin/search/music15 crGET - Search videosReturns videos matching a keyword, with sort, recency, duration and content-type filters.
/v2/douyin/search/videos15 crGET
Trends
4 endpoints- Get the brand boardReturns the ranked brands in one category of Douyin's brand board.
/v2/douyin/trends/brands2 crGET - Get the hot search boardReturns Douyin's in-app hot-search ranking. No query fields are required.
/v2/douyin/trends/hot-search2 crGET - Get the music chartReturns Douyin's music chart. The entries are under music_list; aweme_list is empty on this endpoint.
/v2/douyin/trends/music2 crGET - List brand categoriesReturns the categories of the brand board, whose ids feed /trends/brands.
/v2/douyin/trends/brands/categories2 crGET
Videos
8 endpoints- Get a video by share URLReturns one public video from a Douyin share link, including a v.douyin.com short link. Use /videos/detail instead if you already have the aweme_id.
/v2/douyin/videos/detail/by-share-url2 crGET - Get a video play URLReturns the best available play URL and file size for one video. Use region to pick the CDN region.
/v2/douyin/videos/play-url8 crGET - Get video detailsReturns one public video. Accepts a bare aweme_id or any douyin.com video URL. For a v.douyin.com short link use /videos/detail/by-share-url instead.
/v2/douyin/videos/detail2 crGET - Get video statisticsReturns like, play and share counts for comma-separated video ids — far cheaper than a full detail call when counters are all you need.
/v2/douyin/videos/statistics2 crGET - List comment repliesReturns replies to one comment. Requires both the aweme_id and the parent comment_id.
/v2/douyin/videos/comments/replies2 crGET - List related videosReturns the videos Douyin recommends alongside a given video.
/v2/douyin/videos/related2 crGET - List video commentsReturns top-level comments on a video. Page with cursor from the previous response.
/v2/douyin/videos/comments2 crGET - List video danmakuReturns danmaku (floating comments) for a time window of one video. duration should be the video length in milliseconds from the video detail.
/v2/douyin/videos/danmaku2 crGET
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v2/douyin/billboard/accounts/search?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.