---
title: "Douyin (TikTok China) API Docs &amp; Endpoint Directory"
description: "Choose JustOneAPI's third-party Douyin data APIs for keyword video search, video details, comments, replies, and user profiles. Find endpoint parameters and a Python tutorial."
---

# 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](./video-search-v4). For later pages, pass both `page` and `searchId`; obtain `searchId` from the previous response's `data.business_config.next_page.search_id`, keeping the keyword and filters unchanged.
- Look up a known video: pass its ID as `videoId` to [Video Details V2](./video-details-v2), or as `awemeId` to [Video Comments V1](./video-comments-v1). Read replies separately with [Comment Replies V1](./comment-replies-v1).
- Research a known creator: use `secUid` with [User Profile V3](./user-profile-v3) or [User Published Videos V1](./user-published-videos-v1).

Follow the existing [Douyin video search, details, and comments Python tutorial](https://justoneapi.com/en/blog/douyin-video-data-api-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](../../usage) 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](../tiktok/), [Douyin E-commerce](../douyin-e-commerce/), or [Douyin Xingtu](../douyin-creator-marketplace-xingtu/) group for those platforms and tasks.

## Available APIs

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Video Search \(V4\)](./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\)](./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\)](./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\)](./hot-list-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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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\)](./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… |

</div>

## 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.

<div class="api-doc-table api-doc-table--platform">

| Endpoint | Method | Description |
| --- | --- | --- |
| [Video Search \(V1\)](./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\)](./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… |

</div>

