# Douyin V2 API

> Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

Page: https://docs.toolzerhub.com/reference/douyin-v2

## Billboard

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get a calendar event](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-calendar-detail.md): `GET /v2/douyin/billboard/calendar/detail`. Returns one event from the marketing calendar.
- [Get a city board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-city.md): `GET /v2/douyin/billboard/city`. Returns the local hot board. Pass city_code from /billboard/city-codes to narrow it.
- [Get a video audience](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-video-audience.md): `GET /v2/douyin/billboard/videos/audience`. Returns who liked a video, broken down demographically. Board-listed videos only, inside Douyin's viewable window.
- [Get account analysis](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-analysis.md): `GET /v2/douyin/billboard/accounts/analysis`. Returns last week's posting analysis for an account.
- [Get account trends](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-trends.md): `GET /v2/douyin/billboard/accounts/trends`. Returns an account's follower series over a lookback window.
- [Get an account audience](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-audience.md): `GET /v2/douyin/billboard/accounts/audience`. Returns the demographic breakdown of an account's followers.
- [Get hot-word details](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-word-detail.md): `GET /v2/douyin/billboard/words/detail`. Returns the detail behind one hot content word, for a given day.
- [Get the account board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-accounts.md): `GET /v2/douyin/billboard/accounts`. Returns the ranked hot accounts for a lookback window.
- [Get the challenge board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-challenges.md): `GET /v2/douyin/billboard/challenges`. Returns the ranked hashtag challenges.
- [Get the hot board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-hot.md): `GET /v2/douyin/billboard/hot`. Returns hot.douyin.com's main board, either as a point-in-time snapshot or aggregated over a date range.
- [Get the rising board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-rising.md): `GET /v2/douyin/billboard/rising`. Returns topics whose popularity is climbing fastest.
- [Get the search board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-searches.md): `GET /v2/douyin/billboard/searches`. Returns the ranked search terms for a lookback window.
- [Get the topic board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-topics.md): `GET /v2/douyin/billboard/topics`. Returns the ranked topics for a lookback window.
- [Get the video board](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-videos.md): `GET /v2/douyin/billboard/videos`. Returns the ranked hot videos for a lookback window.
- [Get video comment keywords](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-video-comment-words.md): `GET /v2/douyin/billboard/videos/comment-words`. Returns the weighted comment word cloud for a video, as used by hot.douyin.com.
- [Get video trends](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-video-trends.md): `GET /v2/douyin/billboard/videos/trends`. Returns 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.
- [List audience accounts](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-audience-accounts.md): `GET /v2/douyin/billboard/accounts/audience/accounts`. Returns up to 20 other creators this account's followers are interested in.
- [List audience searches](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-audience-searches.md): `GET /v2/douyin/billboard/accounts/audience/searches`. Returns up to 10 terms this account's followers searched in the last three days.
- [List audience topics](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-account-audience-topics.md): `GET /v2/douyin/billboard/accounts/audience/topics`. Returns up to 10 topics this account's followers engaged with in the last three days.
- [List board categories](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-categories.md): `GET /v2/douyin/billboard/categories`. Returns the category tags for a board, for use as the tag filter elsewhere.
- [List calendar events](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-calendar.md): `GET /v2/douyin/billboard/calendar`. Returns Douyin's marketing event calendar for a date range, as Unix timestamps in seconds.
- [List city codes](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-city-codes.md): `GET /v2/douyin/billboard/city-codes`. Returns the ~394 Chinese city codes accepted by the city board.
- [List content tags](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-content-tags.md): `GET /v2/douyin/billboard/content-tags`. Returns the vertical content tags used across the boards.
- [List high-completion-rate videos](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-high-play.md): `GET /v2/douyin/billboard/high-completion-rate`. Returns videos ranked by watch-through rate.
- [List high-follow-rate videos](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-high-fan.md): `GET /v2/douyin/billboard/high-follow-rate`. Returns videos ranked by how many followers they won.
- [List high-like-rate videos](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-high-like.md): `GET /v2/douyin/billboard/high-like-rate`. Returns videos ranked by like rate rather than raw likes.
- [List hot words](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-words.md): `GET /v2/douyin/billboard/words`. Returns the hot content words for a lookback window.
- [List low-follower hits](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-low-fan-hits.md): `GET /v2/douyin/billboard/low-follower-hits`. Returns videos that went hot despite a small follower count (低粉爆款).
- [List rising searches](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-rising-searches.md): `GET /v2/douyin/billboard/rising-searches`. Returns search terms whose volume is climbing fastest.
- [List rising topics](https://docs.toolzerhub.com/reference/douyin-v2/billboard/get-douyin-billboard-rising-topics.md): `GET /v2/douyin/billboard/rising-topics`. Returns topics whose popularity is climbing fastest.
- [Search board accounts](https://docs.toolzerhub.com/reference/douyin-v2/billboard/search-douyin-billboard-accounts.md): `GET /v2/douyin/billboard/accounts/search`. Finds accounts by nickname or Douyin handle, returning follower, like and publish counts.

## Collections

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get collection details](https://docs.toolzerhub.com/reference/douyin-v2/collections/get-douyin-collection-detail.md): `GET /v2/douyin/collections/detail`. Returns one collection (mix / 合集). Accepts a collection_id or a douyin.com/collection/ URL.
- [Get series details](https://docs.toolzerhub.com/reference/douyin-v2/collections/get-douyin-series-detail.md): `GET /v2/douyin/collections/series/detail`. Returns one 短剧 series by series_id.
- [List collection videos](https://docs.toolzerhub.com/reference/douyin-v2/collections/get-douyin-collection-videos.md): `GET /v2/douyin/collections/videos`. Returns the videos in a collection, in episode order.
- [List series episodes](https://docs.toolzerhub.com/reference/douyin-v2/collections/get-douyin-series-videos.md): `GET /v2/douyin/collections/series/videos`. Returns the episodes of a 短剧 series.

## Feeds

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get a channel feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-channel-feed.md): `GET /v2/douyin/feeds/channel`. Returns the recommendation feed for a channel tag_id.
- [Get the anime feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-anime-feed.md): `GET /v2/douyin/feeds/anime`. Returns Douyin's 二次元 recommendation feed.
- [Get the food feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-food-feed.md): `GET /v2/douyin/feeds/food`. Returns Douyin's food recommendation feed.
- [Get the gaming feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-game-feed.md): `GET /v2/douyin/feeds/game`. Returns Douyin's gaming recommendation feed.
- [Get the home feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-home-feed.md): `GET /v2/douyin/feeds/home`. Returns Douyin's guest home feed.
- [Get the knowledge feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-knowledge-feed.md): `GET /v2/douyin/feeds/knowledge`. Returns Douyin's knowledge recommendation feed.
- [Get the music feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-music-feed.md): `GET /v2/douyin/feeds/music`. Returns Douyin's music recommendation feed.
- [Get the short-drama feed](https://docs.toolzerhub.com/reference/douyin-v2/feeds/get-douyin-series-feed.md): `GET /v2/douyin/feeds/series`. Returns Douyin's 短剧 feed as card_list. Page with offset.

## Hashtags

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get hashtag details](https://docs.toolzerhub.com/reference/douyin-v2/hashtags/get-douyin-hashtag-detail.md): `GET /v2/douyin/hashtags/detail`. Returns one hashtag (challenge). Accepts a hashtag_id or a douyin.com/hashtag/ URL.
- [List hashtag videos](https://docs.toolzerhub.com/reference/douyin-v2/hashtags/get-douyin-hashtag-videos.md): `GET /v2/douyin/hashtags/videos`. Returns 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.

## Live

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get a gift ranking](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-gift-ranking.md): `GET /v2/douyin/live/gift-ranking`. Returns the gift-giver ranking for a live room.
- [Get a live room by room ID](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-room-by-room-id.md): `GET /v2/douyin/live/room/by-room-id`. Returns a live room by its internal room_id, which differs from the webcast id in the URL.
- [Get a live room by user](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-room-by-user.md): `GET /v2/douyin/live/room/by-user`. Returns the live room for a sec_user_id, including the stream URLs when the account is broadcasting.
- [Get a live room by webcast ID](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-room-by-webcast-id.md): `GET /v2/douyin/live/room/by-webcast-id`. Returns a live room by webcast_id. Accepts a live.douyin.com/ URL.
- [Get live status](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-user-status.md): `GET /v2/douyin/live/status`. Returns a user's live status by numeric uid. user_live is empty when the account is not broadcasting.
- [List live room products](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-room-products.md): `GET /v2/douyin/live/products`. Returns the products on sale in a live room. Requires both the room_id and the host's author_id.
- [Resolve a live room ID](https://docs.toolzerhub.com/reference/douyin-v2/live/get-douyin-live-room-id.md): `GET /v2/douyin/live/room-id`. Resolves the webcast_id in a live.douyin.com URL to the room_id other live endpoints require.

## Music

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get sound details](https://docs.toolzerhub.com/reference/douyin-v2/music/get-douyin-music-detail.md): `GET /v2/douyin/music/detail`. Returns one Douyin sound. Accepts a music_id or a douyin.com/music/ URL.
- [List sound videos](https://docs.toolzerhub.com/reference/douyin-v2/music/get-douyin-music-videos.md): `GET /v2/douyin/music/videos`. Returns videos published with a given sound.

## Profiles

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get a profile](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-info.md): `GET /v2/douyin/profiles/info`. Returns one public profile. Accepts a sec_user_id or a douyin.com/user/ profile URL.
- [Get a profile by handle](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-info-by-username.md): `GET /v2/douyin/profiles/info/by-username`. Returns one public profile for a Douyin handle (抖音号).
- [Get a profile by short ID](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-info-by-short-id.md): `GET /v2/douyin/profiles/info/by-short-id`. Returns one public profile for a Douyin short_id.
- [Get a profile by user ID](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-info-by-uid.md): `GET /v2/douyin/profiles/info/by-uid`. Returns one public profile for a numeric uid, as an alternative to the sec_user_id the main profile endpoint takes.
- [List collection folder videos](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-collection-folder-videos.md): `GET /v2/douyin/profiles/collections/videos`. Returns the videos saved in a public 收藏夹, by collection_id.
- [List profile series](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-series.md): `GET /v2/douyin/profiles/series`. Returns the 短剧 series published by a profile. series_infos is null for accounts that publish none.
- [List profile videos](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-posts.md): `GET /v2/douyin/profiles/posts`. Returns videos posted by a profile. Page with cursor, taking the value from the previous response's max_cursor.
- [List publicly liked videos](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-user-likes.md): `GET /v2/douyin/profiles/likes`. Returns videos a profile has publicly liked. Empty for accounts that hide their likes, which is the Douyin default.
- [Resolve a secure user ID](https://docs.toolzerhub.com/reference/douyin-v2/profiles/get-douyin-sec-user-id.md): `GET /v2/douyin/profiles/sec-user-id`. Resolves a numeric uid to the sec_user_id other endpoints require.

## Search

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get hashtag suggestions](https://docs.toolzerhub.com/reference/douyin-v2/search/get-douyin-hashtag-suggestions.md): `GET /v2/douyin/search/suggestions/hashtags`. Returns suggested hashtags for a keyword.
- [Get search suggestions](https://docs.toolzerhub.com/reference/douyin-v2/search/get-douyin-search-suggestions.md): `GET /v2/douyin/search/suggestions`. Returns Douyin's autocomplete suggestions for a keyword.
- [Search all content](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin.md): `GET /v2/douyin/search`. Douyin's comprehensive search: mixed videos, accounts and hashtags for a keyword. Page by sending back both cursor and search_id from the previous response.
- [Search discussions](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-discussions.md): `GET /v2/douyin/search/discussions`. Returns discussion results for a keyword, inside Douyin's business_data envelope.
- [Search experiences](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-experiences.md): `GET /v2/douyin/search/experiences`. Returns 经验 results for a keyword, inside Douyin's business_data envelope.
- [Search hashtags](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-hashtags.md): `GET /v2/douyin/search/hashtags`. Returns hashtags (challenges) matching a keyword.
- [Search image posts](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-images.md): `GET /v2/douyin/search/images`. Returns image/text posts matching a keyword. Records arrive inside Douyin's own business_data envelope — no unwrapped version of this endpoint exists.
- [Search multiple content types](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-multi.md): `GET /v2/douyin/search/multi`. Returns Douyin's multi-type search, an array of typed result blocks.
- [Search profiles](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-users.md): `GET /v2/douyin/search/users`. Returns accounts matching a keyword, optionally narrowed by follower band and account type.
- [Search schools](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-schools.md): `GET /v2/douyin/search/schools`. Returns schools matching a keyword, as used by Douyin's campus tagging.
- [Search sounds](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-music.md): `GET /v2/douyin/search/music`. Returns sounds matching a keyword.
- [Search videos](https://docs.toolzerhub.com/reference/douyin-v2/search/search-douyin-videos.md): `GET /v2/douyin/search/videos`. Returns videos matching a keyword, with sort, recency, duration and content-type filters.

## Trends

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get the brand board](https://docs.toolzerhub.com/reference/douyin-v2/trends/get-douyin-brand-board.md): `GET /v2/douyin/trends/brands`. Returns the ranked brands in one category of Douyin's brand board.
- [Get the hot search board](https://docs.toolzerhub.com/reference/douyin-v2/trends/get-douyin-hot-search.md): `GET /v2/douyin/trends/hot-search`. Returns Douyin's in-app hot-search ranking. No query fields are required.
- [Get the music chart](https://docs.toolzerhub.com/reference/douyin-v2/trends/get-douyin-music-chart.md): `GET /v2/douyin/trends/music`. Returns Douyin's music chart. The entries are under music_list; aweme_list is empty on this endpoint.
- [List brand categories](https://docs.toolzerhub.com/reference/douyin-v2/trends/get-douyin-brand-categories.md): `GET /v2/douyin/trends/brands/categories`. Returns the categories of the brand board, whose ids feed /trends/brands.

## Videos

Access public Douyin profiles, videos, comments, sounds, hashtags, collections, short dramas, trends, recommendations, and live rooms.

- [Get a video by share URL](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-detail-by-share-url.md): `GET /v2/douyin/videos/detail/by-share-url`. Returns 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.
- [Get a video play URL](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-play-url.md): `GET /v2/douyin/videos/play-url`. Returns the best available play URL and file size for one video. Use region to pick the CDN region.
- [Get video details](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-detail.md): `GET /v2/douyin/videos/detail`. Returns 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.
- [Get video statistics](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-statistics.md): `GET /v2/douyin/videos/statistics`. Returns like, play and share counts for comma-separated video ids — far cheaper than a full detail call when counters are all you need.
- [List comment replies](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-comment-replies.md): `GET /v2/douyin/videos/comments/replies`. Returns replies to one comment. Requires both the aweme_id and the parent comment_id.
- [List related videos](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-related-videos.md): `GET /v2/douyin/videos/related`. Returns the videos Douyin recommends alongside a given video.
- [List video comments](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-comments.md): `GET /v2/douyin/videos/comments`. Returns top-level comments on a video. Page with cursor from the previous response.
- [List video danmaku](https://docs.toolzerhub.com/reference/douyin-v2/videos/get-douyin-video-danmaku.md): `GET /v2/douyin/videos/danmaku`. Returns danmaku (floating comments) for a time window of one video. duration should be the video length in milliseconds from the video detail.