Douyin 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 eventGETReturns one event from the marketing calendar.
/v2/douyin/billboard/calendar/detail2 cr - Get a city boardGETReturns the local hot board. Pass city_code from /billboard/city-codes to narrow it.
/v2/douyin/billboard/city2 cr - Get a video audienceGETReturns who liked a video, broken down demographically. Board-listed videos only, inside Douyin's viewable window.
/v2/douyin/billboard/videos/audience2 cr - Get account analysisGETReturns last week's posting analysis for an account.
/v2/douyin/billboard/accounts/analysis2 cr - Get account trendsGETReturns an account's follower series over a lookback window.
/v2/douyin/billboard/accounts/trends2 cr - Get an account audienceGETReturns the demographic breakdown of an account's followers.
/v2/douyin/billboard/accounts/audience2 cr - Get hot-word detailsGETReturns the detail behind one hot content word, for a given day.
/v2/douyin/billboard/words/detail2 cr - Get the account boardGETReturns the ranked hot accounts for a lookback window.
/v2/douyin/billboard/accounts2 cr - Get the challenge boardGETReturns the ranked hashtag challenges.
/v2/douyin/billboard/challenges2 cr - Get the hot boardGETReturns hot.douyin.com's main board, either as a point-in-time snapshot or aggregated over a date range.
/v2/douyin/billboard/hot2 cr - Get the rising boardGETReturns topics whose popularity is climbing fastest.
/v2/douyin/billboard/rising2 cr - Get the search boardGETReturns the ranked search terms for a lookback window.
/v2/douyin/billboard/searches2 cr - Get the topic boardGETReturns the ranked topics for a lookback window.
/v2/douyin/billboard/topics2 cr - Get the video boardGETReturns the ranked hot videos for a lookback window.
/v2/douyin/billboard/videos2 cr - Get video comment keywordsGETReturns the weighted comment word cloud for a video, as used by hot.douyin.com.
/v2/douyin/billboard/videos/comment-words2 cr - Get video trendsGETReturns 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 cr - List audience accountsGETReturns up to 20 other creators this account's followers are interested in.
/v2/douyin/billboard/accounts/audience/accounts2 cr - List audience searchesGETReturns up to 10 terms this account's followers searched in the last three days.
/v2/douyin/billboard/accounts/audience/searches2 cr - List audience topicsGETReturns up to 10 topics this account's followers engaged with in the last three days.
/v2/douyin/billboard/accounts/audience/topics2 cr - List board categoriesGETReturns the category tags for a board, for use as the tag filter elsewhere.
/v2/douyin/billboard/categories2 cr - List calendar eventsGETReturns Douyin's marketing event calendar for a date range, as Unix timestamps in seconds.
/v2/douyin/billboard/calendar2 cr - List city codesGETReturns the ~394 Chinese city codes accepted by the city board.
/v2/douyin/billboard/city-codes2 cr - List content tagsGETReturns the vertical content tags used across the boards.
/v2/douyin/billboard/content-tags2 cr - List high-completion-rate videosGETReturns videos ranked by watch-through rate.
/v2/douyin/billboard/high-completion-rate2 cr - List high-follow-rate videosGETReturns videos ranked by how many followers they won.
/v2/douyin/billboard/high-follow-rate2 cr - List high-like-rate videosGETReturns videos ranked by like rate rather than raw likes.
/v2/douyin/billboard/high-like-rate2 cr - List hot wordsGETReturns the hot content words for a lookback window.
/v2/douyin/billboard/words2 cr - List low-follower hitsGETReturns videos that went hot despite a small follower count (低粉爆款).
/v2/douyin/billboard/low-follower-hits2 cr - List rising searchesGETReturns search terms whose volume is climbing fastest.
/v2/douyin/billboard/rising-searches2 cr - List rising topicsGETReturns topics whose popularity is climbing fastest.
/v2/douyin/billboard/rising-topics2 cr - Search board accountsGETFinds accounts by nickname or Douyin handle, returning follower, like and publish counts.
/v2/douyin/billboard/accounts/search2 cr
Collections
4 endpoints- Get collection detailsGETReturns one collection (mix / 合集). Accepts a collection_id or a douyin.com/collection/ URL.
/v2/douyin/collections/detail2 cr - Get series detailsGETReturns one 短剧 series by series_id.
/v2/douyin/collections/series/detail2 cr - List collection videosGETReturns the videos in a collection, in episode order.
/v2/douyin/collections/videos2 cr - List series episodesGETReturns the episodes of a 短剧 series.
/v2/douyin/collections/series/videos2 cr
Feeds
8 endpoints- Get a channel feedGETReturns the recommendation feed for a channel tag_id.
/v2/douyin/feeds/channel2 cr - Get the anime feedGETReturns Douyin's 二次元 recommendation feed.
/v2/douyin/feeds/anime2 cr - Get the food feedGETReturns Douyin's food recommendation feed.
/v2/douyin/feeds/food2 cr - Get the gaming feedGETReturns Douyin's gaming recommendation feed.
/v2/douyin/feeds/game2 cr - Get the home feedGETReturns Douyin's guest home feed.
/v2/douyin/feeds/home2 cr - Get the knowledge feedGETReturns Douyin's knowledge recommendation feed.
/v2/douyin/feeds/knowledge2 cr - Get the music feedGETReturns Douyin's music recommendation feed.
/v2/douyin/feeds/music2 cr - Get the short-drama feedGETReturns Douyin's 短剧 feed as card_list. Page with offset.
/v2/douyin/feeds/series2 cr
Hashtags
2 endpoints- Get hashtag detailsGETReturns one hashtag (challenge). Accepts a hashtag_id or a douyin.com/hashtag/ URL.
/v2/douyin/hashtags/detail2 cr - List hashtag videosGETReturns 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 cr
Live
7 endpoints- Get a gift rankingGETReturns the gift-giver ranking for a live room.
/v2/douyin/live/gift-ranking2 cr - Get a live room by room IDGETReturns a live room by its internal room_id, which differs from the webcast id in the URL.
/v2/douyin/live/room/by-room-id2 cr - Get a live room by userGETReturns the live room for a sec_user_id, including the stream URLs when the account is broadcasting.
/v2/douyin/live/room/by-user2 cr - Get a live room by webcast IDGETReturns a live room by webcast_id. Accepts a live.douyin.com/ URL.
/v2/douyin/live/room/by-webcast-id2 cr - Get live statusGETReturns a user's live status by numeric uid. user_live is empty when the account is not broadcasting.
/v2/douyin/live/status2 cr - List live room productsGETReturns the products on sale in a live room. Requires both the room_id and the host's author_id.
/v2/douyin/live/products2 cr - Resolve a live room IDGETResolves the webcast_id in a live.douyin.com URL to the room_id other live endpoints require.
/v2/douyin/live/room-id2 cr
Music
2 endpointsProfiles
9 endpoints- Get a profileGETReturns one public profile. Accepts a sec_user_id or a douyin.com/user/ profile URL.
/v2/douyin/profiles/info2 cr - Get a profile by handleGETReturns one public profile for a Douyin handle (抖音号).
/v2/douyin/profiles/info/by-username2 cr - Get a profile by short IDGETReturns one public profile for a Douyin short_id.
/v2/douyin/profiles/info/by-short-id2 cr - Get a profile by user IDGETReturns 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 cr - List collection folder videosGETReturns the videos saved in a public 收藏夹, by collection_id.
/v2/douyin/profiles/collections/videos2 cr - List profile seriesGETReturns the 短剧 series published by a profile. series_infos is null for accounts that publish none.
/v2/douyin/profiles/series2 cr - List profile videosGETReturns videos posted by a profile. Page with cursor, taking the value from the previous response's max_cursor.
/v2/douyin/profiles/posts2 cr - List publicly liked videosGETReturns videos a profile has publicly liked. Empty for accounts that hide their likes, which is the Douyin default.
/v2/douyin/profiles/likes2 cr - Resolve a secure user IDGETResolves a numeric uid to the sec_user_id other endpoints require.
/v2/douyin/profiles/sec-user-id2 cr
Search
12 endpoints- Get hashtag suggestionsGETReturns suggested hashtags for a keyword.
/v2/douyin/search/suggestions/hashtags15 cr - Get search suggestionsGETReturns Douyin's autocomplete suggestions for a keyword.
/v2/douyin/search/suggestions15 cr - Search all contentGETDouyin'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 cr - Search discussionsGETReturns discussion results for a keyword, inside Douyin's business_data envelope.
/v2/douyin/search/discussions15 cr - Search experiencesGETReturns 经验 results for a keyword, inside Douyin's business_data envelope.
/v2/douyin/search/experiences15 cr - Search hashtagsGETReturns hashtags (challenges) matching a keyword.
/v2/douyin/search/hashtags15 cr - Search image postsGETReturns 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 cr - Search multiple content typesGETReturns Douyin's multi-type search, an array of typed result blocks.
/v2/douyin/search/multi15 cr - Search profilesGETReturns accounts matching a keyword, optionally narrowed by follower band and account type.
/v2/douyin/search/users15 cr - Search schoolsGETReturns schools matching a keyword, as used by Douyin's campus tagging.
/v2/douyin/search/schools15 cr - Search soundsGETReturns sounds matching a keyword.
/v2/douyin/search/music15 cr - Search videosGETReturns videos matching a keyword, with sort, recency, duration and content-type filters.
/v2/douyin/search/videos15 cr
Trends
4 endpoints- Get the brand boardGETReturns the ranked brands in one category of Douyin's brand board.
/v2/douyin/trends/brands2 cr - Get the hot search boardGETReturns Douyin's in-app hot-search ranking. No query fields are required.
/v2/douyin/trends/hot-search2 cr - Get the music chartGETReturns Douyin's music chart. The entries are under music_list; aweme_list is empty on this endpoint.
/v2/douyin/trends/music2 cr - List brand categoriesGETReturns the categories of the brand board, whose ids feed /trends/brands.
/v2/douyin/trends/brands/categories2 cr
Videos
8 endpoints- Get a video by share URLGETReturns 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 cr - Get a video play URLGETReturns the best available play URL and file size for one video. Use region to pick the CDN region.
/v2/douyin/videos/play-url8 cr - Get video detailsGETReturns 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 cr - Get video statisticsGETReturns 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 cr - List comment repliesGETReturns replies to one comment. Requires both the aweme_id and the parent comment_id.
/v2/douyin/videos/comments/replies2 cr - List related videosGETReturns the videos Douyin recommends alongside a given video.
/v2/douyin/videos/related2 cr - List video commentsGETReturns top-level comments on a video. Page with cursor from the previous response.
/v2/douyin/videos/comments2 cr - List video danmakuGETReturns 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 cr
What you can build
- Research creators and their published videos.
- Explore hashtag, music, and commerce content.
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.