Douyin Data API
Douyin Data API provides structured access to public Douyin data through RapidAPI, including video search, video details, creator profiles, creator videos, comments and replies, music, hashtags, trends, rankings, URL resolution, and batch endpoints. Responses use consistent JSON envelopes and support cursor pagination, compact responses on selected video-list endpoints, raw mode for advanced…
Douyin Data API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Search | ||
| GET |
Search Videos /search |
Search Douyin videos by keyword. Use the returned next_cursor as the cursor value for the next page. Set full=true to enrich each result with full video detail fields. Max count… |
| GET |
Search Suggestions /search/sug |
Get Douyin search keyword suggestions for topic discovery and keyword research. This endpoint returns keyword suggestions only, not video search results. Set raw=true to include… |
| GET |
Search All /search/all |
Search Douyin mixed results, including videos, related words, guide search words, Aladdin cards, music cards, and commerce cards when present. Use the returned next_cursor to… |
| GET |
Search Users /search/users |
Search Douyin creator accounts by keyword. The count range is 1–20. Use the returned next_cursor to request the next page when has_more=1. |
| GET |
Related Search Words /search/related-words |
Get related search words from Douyin mixed search results for keyword expansion, topic discovery, and search research. |
| Video | ||
| GET |
Video Detail /video/detail |
Get details for a Douyin video by video_id. Set raw=true to include raw_aweme from the original Douyin aweme_detail response. |
| GET |
Related Videos /video/related |
Get one batch of videos related to a Douyin video. The count range is 1–30. Pagination is not supported by the upstream source, so has_more is always 0 and next_cursor is always… |
| GET |
Video Danmaku /video/danmaku |
Get danmaku or bullet comments for a Douyin video when available. The count range is 1–100. Some videos do not contain danmaku, so an empty array can be a valid result. |
| User | ||
| GET |
User Videos /user/videos |
Get videos posted by a Douyin user. Use the returned next_cursor as the cursor value for the next page. The count range is 1–35. |
| GET |
User Info /user/info |
Get Douyin user profile data by sec_uid, including nickname, avatar, follower count, following count, and video count. |
| Comment | ||
| GET |
Comment Replies /comment/replies |
Get replies to a Douyin comment by video_id and comment_id. Use the returned next_cursor as the cursor value for the next page. The count range is 1–50. |
| GET |
Comment List /comment/list |
Get comments for a Douyin video by video_id. Use the returned next_cursor as the cursor value for the next page. The count range is 1–50. |
| Mix | ||
| GET |
Mix List /mix/list |
Get Douyin mix/collection list by user sec_uid. Use the returned next_cursor as the cursor value for the next page. Set raw=true to include raw_response and raw_mix_info. The… |
| GET |
Mix Detail /mix/detail |
Get Douyin mix/collection detail by mix_id. Set raw=true to include the original raw_response. |
| Resolve | ||
| GET |
Resolve Share URL /resolve |
Resolve a single Douyin share URL, short URL, video URL, note URL, or user URL. Returns parsed IDs and basic information when available. |
| Batch | ||
| POST |
Batch User Info /batch/user/info |
Get profile data for multiple Douyin users by sec_uids. |
| POST |
Batch Video Details /batch/video/detail |
Get details for multiple Douyin videos by video_ids. Set raw=true to include raw_aweme for each video item. The video_ids array must contain 1–30 items. |
| POST |
Batch Resolve /batch/resolve |
Resolve multiple Douyin share URLs. Returned identifiers may appear in aweme_id, uid, or sec_uid depending on the resolved content type. The urls array must contain 1–30 items. |
| POST |
Batch Video Metrics /batch/video/metrics |
Get compact metrics and aggregate analytics for multiple Douyin videos. The video_ids array must contain between 1 and 30 items. |
| System | ||
| GET |
Health Check /health |
Check API service status and upstream Douyin cookie/session status. |
| Analytics | ||
| GET |
Video Metrics /video/metrics |
Get a compact analytics-oriented metrics view for one video. |
| GET |
Creator Overview /user/overview |
Get creator profile, recent videos, collections, and lightweight aggregate metrics. |
| GET |
Comment Thread /comment/thread |
Get a top-level comment and its reply thread in one call.The count range is 1–50. Use the returned next_cursor for the next page when has_more=1. |
| GET |
Video Insights /video/insights |
Get a one-call video intelligence view with full detail, metrics, comments, and related videos. comment_count must be between 1 and 30. related_count must be between 1 and 20. |
| GET |
Comment Tree /comment/tree |
Get top-level comments with nested reply previews for comments that have replies. The count range is 1–20 and replies_per_comment range is 0–10. Use the returned next_cursor to… |
| GET |
Keyword Overview /keyword/overview |
Get keyword discovery results with enriched videos, aggregate metrics, hashtags, creators, music, and suggestions. The count range is 1–10. Use the returned next_cursor to… |
| GET |
Creator Insights /user/insights |
Get a richer creator intelligence view with profile, recent videos, aggregate metrics, hashtags, music, and mixes. video_count must be between 1 and 30. mix_count must be between… |
| GET |
Comment Insights /comment/insights |
Analyze a comment page with top comments, reply distribution, active commenters, and optional reply previews. count must be between 1 and 50. replies_per_comment must be between… |
| Trending | ||
| GET |
Rising Trends /trending/rising |
Get Douyin real-time rising trend topics, including trend words, sentence IDs, group IDs, event times, video counts, discussion counts, covers, tags, and hotlist parameters. |
| GET |
Hot Search /trending/hot-search |
Get Douyin hot search ranking data. The count range is 1–50. Set detail_list=true to include detailed ranking information. |
| Music | ||
| GET |
Music Detail /music/detail |
Get Douyin music or sound detail by music_id. |
| GET |
Music Videos /music/videos |
Get videos using a Douyin music or sound. The count range is 1–30. Use the returned next_cursor to request the next page when has_more=1. |
| Hashtag | ||
| GET |
Hashtag Detail /hashtag/detail |
Get Douyin hashtag or challenge detail by hashtag_id. |
| GET |
Hashtag Videos /hashtag/videos |
Get videos under a Douyin hashtag or challenge. The count range is 1–30. Use the returned next_cursor to request the next page when has_more=1. |
| Billboard | ||
| GET |
Live Billboard /billboard/live |
Get Douyin Creator live billboard ranking data, including ranked live room items, author names, room IDs, covers, links, hot values, and the billboard time window. |
| GET |
Music Billboard /billboard/music |
Get Douyin Creator music billboard ranking data, including music IDs, titles, covers, engagement metrics, publis |
| GET |
Video Billboard /billboard/videos |
Get Douyin Creator hot video billboard ranking data, including video IDs, titles, covers, author info, engagement metrics, hot scores, keywords, and ranking positions. |
| GET |
Topic Billboard /billboard/topics |
Get Douyin Creator hot topic billboard ranking data, including topic IDs, titles, covers, engagement metrics, hot scores, related keywords, and ranking positions. |
| GET |
Challenge Billboard /billboard/challenges |
Get Douyin Creator hot challenge billboard ranking data, including challenge IDs, titles, covers, engagement metrics, hot scores, related keywords, and ranking positions. |
| GET |
Creative Hotspot Billboard /billboard/hotspots |
Get Douyin Creator creative hotspot ranking data, including hotspot titles, categories, covers, hot scores, rank changes, query IDs, and ranking positions. |
| GET |
Effect Billboard /billboard/effects |
Get Douyin Creator effect/tool billboard ranking data, including effect IDs, titles, covers, hot scores, play counts, keywords, collection status, related item IDs, ranking… |
| Creator Center | ||
| GET |
Creator Activities /creator/activities |
Get Douyin Creator Center activity calendar opportunities, including activity tags, incentives, recommendations, activity windows, jump links, hot scores, and collection/hot… |
| GET |
Creator Attention Videos /creator/attention-videos |
Get videos from Douyin Creator Center related-video attention search, including video IDs, encrypted item IDs, titles, covers, publish times, author nicknames, avatars, and… |
| GET |
Creator Activity Detail /creator/activity/detail |
Get Douyin Creator activity detail, including activity rules, topics, challenge IDs, reward rules, publish windows, cover image, hot score, collection status, and demo videos. |
| GET |
Creator Item Detail /creator/item/detail |
Get Douyin Creator Center item detail by encrypted sec_item_id, including video ID, title, cover, play URL, share URL, counts, music URL, and author profile fields. |
| GET |
Creator Item Comments /creator/item/comments |
Get Douyin Creator Center item comments by encrypted sec_item_id, including comment text, images, like count, reply count, author profile, follow status, and creator-side… |
Douyin Data API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9 / month | 4 / second |
|
| ULTRA | $29 / month | 8 / second |
|