Social data API · integration guide
Douyin API: video search, comments and replies
Use ChinaAPI to search public Douyin content, retrieve a video and collect available comments and replies. Each capability has its own request parameters and per-call price; this is a third-party integration, not an official Douyin developer API.
Choose a video before collecting comments
Start with keyword search, select a relevant result and retain its aweme_id as a string. Pass that ID to the comments endpoint; the post endpoint expects share_url. A video URL is not interchangeable with an aweme_id.
Comment pages and replies have different identifiers
Comments use aweme_id. Replies use item_id for the video and comment_id for a parent comment. Start cursor at 0 and count at 20. The current comments contract uses App V3 cursors; do not reuse a cursor saved from an older Web implementation.
Avoid paying repeatedly for overlapping pages
Pages can contain repeated comments even when the cursor advances. Deduplicate by cid, stop on a repeated cursor or a page without new IDs, and set a hard maximum number of pages. Each successful page is billed even when some items overlap.
What a result does and does not establish
Returned comments are a sample available at request time. Deleted content, visibility changes and retrieval limits can affect results. Do not present a bounded collection as the complete discussion or a representative audience survey.
Available endpoints and USD prices
Per successful synchronous call. First top-up required. Captured 2026-10-29T17:56:18Z from the public catalog.
| Capability | Endpoint | USD / call |
|---|---|---|
| Search posts | GET /v1/social/douyin/search | $0.02 |
| Post details | GET /v1/social/douyin/post | $0.002 |
| Profiles | GET /v1/social/douyin/user | $0.006 |
| Comments | GET /v1/social/douyin/comments | $0.002 |
| Comment replies | GET /v1/social/douyin/comment-replies | $0.002 |
| User posts | GET /v1/social/douyin/user-posts | $0.002 |
| Trending | GET /v1/social/douyin/trending | $0.002 |
Request example
curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/search" \
-H "Authorization: Bearer $CHINAAPI_API_KEY" \
--data-urlencode 'keyword=猫咪'Keep the key server-side. Replace resource identifiers with the content you intend to retrieve.
Billing and limits
Beta: paid accounts only. Complete your first top-up before calling this API. Trial credits cannot be used for social-data requests. This beta has no SLA and platform coverage may change.
You must comply with each platform's terms and applicable data rules. Do not use this API to build personal profiles. Login, contact extraction, engagement manipulation, and private or paid-content access are outside this beta.
Calls use your existing ChinaAPI key and balance. Synchronous calls charge only for HTTP 200 with data. Async POST creation reserves the price; failed or empty tasks are refunded, and GET task reads are free. Empty or failed results are not charged. A daily beta budget may return HTTP 429; retry after the UTC day resets. Repeating a successful synchronous request creates another billable call. Retry async creation with the same Idempotency-Key to avoid duplicate submissions.
Every successful page is separately billed. Prices and parameters can change; check the reference before deployment.