Douyin
Douyin API reference: 8 endpoints for creators, videos, comments, search and trending. Per-endpoint credit prices and cURL examples.
Creator profiles, videos, comments and replies, creator and video search, and the hot-search board.
Base path: /v1/douyin/...
Quickstart
curl "https://api.insightsocial.app/v1/douyin/profile?url=https%3A%2F%2Fwww.douyin.com%2Fuser%2FMS4wLjABAAAAtxsy7VmVkU3RN9oIX0vdkh_6-LlQAb0gwI-tDf-bYNg" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
5 of these are metered: the price depends on how much the call reads. See Credits.
1 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/search | 50–1250 | Returns Douyin videos matching a keyword: caption, creator, likes, comments, shares, saves, hashtags, music, cover image, and duration. | query |
/profile | 60 | Returns a Douyin creator's profile: nickname, Douyin ID, bio, avatar, follower and following counts, total likes received, video count, region, and verification. | handle, url, id |
/profile/posts | 50–1250 | Returns a Douyin creator's recent videos, newest first: caption, likes, comments, shares, saves, hashtags, music, and cover image. | handle, url, id |
/post | 100 | Returns one Douyin video: caption, creator, likes, comments, shares, saves, hashtags, music, duration, dimensions, cover image, and tagged place when set. | url |
/post/comments | 20–1000 | Returns top-level comments on a Douyin video: text, commenter, like count, reply count, IP region, and whether the creator liked it. | url |
/comment/replies | 50–2500 | Returns the reply thread under one Douyin comment: text, replier, like count, IP region, and verification, each tagged with the parent comment id. | url, comment_id |
/search/users | 50–1250 | Returns Douyin creators matching a keyword: nickname, Douyin ID, bio, follower count, total likes received, avatar, profile URL, and verification label. | query |
/trending | 250 | Returns the live Douyin hot-search board: roughly 50 trending topics with rank, hot value, view count, video count, and the time each topic broke. Beta. | — |