Douyin (TikTok China) API Docs & Endpoint Directory
JustOneAPI provides third-party Douyin data APIs for content discovery, video lookup, and creator research. These are data-reading endpoints; official account authorization and content publishing are separate development needs.
Choose an endpoint for your task
- Discover videos by keyword: start with Video Search V4. For later pages, pass both
pageandsearchId; obtainsearchIdfrom the previous response'sdata.business_config.next_page.search_id, keeping the keyword and filters unchanged. - Look up a known video: pass its ID as
videoIdto Video Details V2, or asawemeIdto Video Comments V1. Read replies separately with Comment Replies V1. - Research a known creator: use
secUidwith User Profile V3 or User Published Videos V1.
Follow the existing Douyin video search, details, and comments Python tutorial for a bounded workflow that saves JSON responses. Permissions, pricing, and available trial allowance are shown in the Dashboard; see the API usage guide before making requests. Search results and returned comments have coverage limits and do not establish a complete dataset.
This group covers mainland China's Douyin. Choose the separate TikTok, Douyin E-commerce, or Douyin Xingtu group for those platforms and tasks.
Available APIs
| Endpoint | Method | Description |
|---|---|---|
| Video Search (V4) | GET | Searches Douyin (TikTok China) videos by keyword with sort, publish-time, duration, and page filters; later pages require the previous search ID. Use it to sup… |
| Image Post Search (V1) | GET | Searches Douyin (TikTok China) image posts by keyword with search-session pagination. Omit searchId for the first page, then use the search ID from the previou… |
| Hot Search (V1) | GET | Searches Douyin (TikTok China) content with optional keyword, category, video-type, ranking, pagination, engagement, and creator-follower filters. Use it to su… |
| Hot Topics Ranking (V1) | GET | Retrieves the current topic ranking from the public Douyin (TikTok China) Hot List. Use it to track trending topics and plan timely content. |
| Live Room Search (V1) | GET | Searches Douyin (TikTok China) live rooms by a creator's Douyin ID or nickname with cursor pagination. Use it to find live rooms for creator discovery and live… |
| User Search (V2) | GET | Searches Douyin (TikTok China) users by keyword with page-based pagination and optional account-type filtering. Use it to discover creators, brands, or verifie… |
| User Published Videos (V1) | GET | Retrieves videos published by a Douyin (TikTok China) user, with cursor pagination and newest or most-popular sorting. Use it to browse or monitor a creator's… |
| Video Details (V2) | GET | Retrieves details for a Douyin (TikTok China) video by video ID. Use it to look up a known video before content review, archiving, or related analysis. |
| Video Comments (V1) | GET | Retrieves top-level comments for a Douyin (TikTok China) video by aweme ID with page-based pagination. Use it to review audience feedback or analyze discussion… |
| Comment Replies (V1) | GET | Retrieves replies to a top-level Douyin (TikTok China) video comment with page-based pagination. Use it to inspect threaded discussions and review feedback und… |
| User Profile (V3) | GET | Retrieves a Douyin (TikTok China) user profile by secUid. Use it to review a known creator or account before monitoring related content or conducting account r… |
| Share Link Resolution (V1) | GET | Resolve a supported Douyin (TikTok China) short share link that targets a video and return its public redirect URL. Use it to expand video links before subsequ… |
Removed APIs
The following endpoints have been removed from the regular catalog, but remain available for existing integrations. We recommend migrating to another version where possible.
| Endpoint | Method | Description |
|---|---|---|
| Video Search (V1) | GET | Searches Douyin (TikTok China) videos through the mobile-app flow. Start with a keyword and optional filters. Continue with only data.business_config.next_page… |
| User Published Videos (V3) | GET | Retrieves videos published by a Douyin (TikTok China) user with cursor pagination. Use it to browse a known creator's public video history or continue through… |