EveryData platform API
Douyin API
The scope of this Douyin API is Douyin videos, creator profiles, comments, trends, and available transcripts; its 7 actions, including `search`, `profile`, `user_posts`, retain independent inputs and returned-object meanings.
In the Douyin catalog, `keyword` drives `search` for matching Douyin results, whereas `user_id` drives `profile` for the selected Douyin record; a shared identifier never merges their response fields.
- Endpoint
- POST /api/v1/social
- Capabilities
- 7
- Per 1,000
- $0.556
Available capabilities
Compare the Douyin actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Douyin. Accepts these parameters: | keyword | publish_time, sort | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
profileProfiles Retrieve public profile details from Douyin. Accepts these parameters: | user_id | since | Sync delivery | — | $0.56 per 1,000 requests | user_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · platform |
user_postsPosts by user Retrieve public posts from Douyin. Accepts these parameters: | user_id | since | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
videoVideo details Retrieve a public video from Douyin. Accepts these parameters: | url | — | Sync delivery | — | $0.56 per 1,000 requests | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
commentsComments Retrieve public comments from Douyin. Accepts these parameters: | url | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · text · like_count · reply_count · author_name · author_id · ip_location · liked_by_author · is_reply · reply_to_id · posted_at · platform |
trendingTrending Retrieve current trends from Douyin. Accepts these parameters: | boards | Sync delivery | Catalog values: defaultLimit=20, maxLimit=60. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | rank · keyword · hot_value · video_count · board · image_url · event_time · platform | |
transcriptTranscript Retrieve a video transcript from Douyin. Accepts these parameters: | url | — | Sync delivery | — | $0.56 per 1,000 requests | id · url · title · text · posted_at · play_count · like_count · comment_count · share_count · collect_count · author_name · author_avatar · author_follower_count · platform |
What does each Douyin action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Douyin search parameters mean?
Search public results on Douyin. Accepts these parameters: publish_time, sort, and keyword. Returns these fields: posted_at, like_count, author_id, and collect_count.
keywordRequired- Search term for the video search action, passed as a string (for example, "latte art"). Used specifically for finding videos, not user nicknames or video IDs.
publish_timeOptional- Filters video search results by publishing time window. Allowed values are
unlimited(default),one_day(last 24 hours),one_week(last 7 days), andhalf_year(last 6 months). sortOptional- Sorts video search results. Allowed values are
relevance(default),newestfor the latest publish date, andmost_likedfor highest likes. Supports legacy compatibility aliasesgeneral(mapped torelevance) andlatest(mapped tonewest).
What do the Douyin profile parameters mean?
Retrieve public profile details from Douyin. Accepts these parameters: since and user_id. Returns these fields: ip_location, gender, is_verified, and like_count.
user_idRequired- The Douyin user's
secUidstring (typically starting withMS4w), not a nickname or short numerical Douyin ID. Used to identify accounts forprofileanduser_postsactions; can be obtained from anauthor_idfield in search results or a user profile URL.Douyin Open Platform: Open ID and Union IDDouyin Open Platform defines Open ID as the user identifier within a single app, whereas Union ID operates across the developer account scope. For this page, user_id expects a secUid per the instructions above; do not supply Open Platform identifiers directly as equivalent inputs.Checked sinceOptional- Sets a lower bound for video publish dates in
profileanduser_postsactions using theYYYY-MM-DDformat. Filters videos retrieved for the request rather than account creation date. Omitting this parameter removes the date filter.
What do the Douyin user_posts parameters mean?
Retrieve public posts from Douyin. Accepts these parameters: since and user_id. Returns these fields: posted_at, share_count, author_douyin_id, and comment_count.
user_idRequired- The Douyin user's
secUidstring (typically starting withMS4w), not a nickname or short numerical Douyin ID. Used to identify accounts forprofileanduser_postsactions; can be obtained from anauthor_idfield in search results or a user profile URL.Douyin Open Platform: Open ID and Union IDDouyin Open Platform defines Open ID as the user identifier within a single app, whereas Union ID operates across the developer account scope. For this page, user_id expects a secUid per the instructions above; do not supply Open Platform identifiers directly as equivalent inputs.Checked sinceOptional- Sets a lower bound for video publish dates in
profileanduser_postsactions using theYYYY-MM-DDformat. Filters videos retrieved for the request rather than account creation date. Omitting this parameter removes the date filter.
What do the Douyin video parameters mean?
Retrieve a public video from Douyin. Accepts these parameters: url. Returns these fields: posted_at, text, author_follower_count, and collect_count.
urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs.
What do the Douyin comments parameters mean?
Retrieve public comments from Douyin. Accepts these parameters: url. Returns these fields: like_count, author_name, reply_count, and posted_at.
urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs.
What do the Douyin trending parameters mean?
Retrieve current trends from Douyin. Accepts these parameters: boards. Returns these fields: board, image_url, video_count, and event_time.
boardsOptional- Specifies trending board types to query in the
trendingaction, passed as a single string or an array of strings:hotspot,seeding,entertainment,social, andchallenge. Defaults tohotspotif omitted or passed as an empty array.
What do the Douyin transcript parameters mean?
Retrieve a video transcript from Douyin. Accepts these parameters: url. Returns these fields: like_count, posted_at, author_follower_count, and author_name.
urlRequired- Full URL of the target Douyin video, formatted as
https://www.douyin.com/video/<video_id>. Fetches video details invideo, comments incomments, or audio transcripts intranscript. Do not pass user profile or search page URLs.
How to use the Douyin API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"douyin","action":"search","params":{"keyword":"<keyword>"}}'
Douyin API questions
What can I retrieve with the Douyin API?
Set platform to douyin. The current catalog lists search, profiles, posts by user, video details, comments, and more. These action names identify different Douyin objects or views; they are not interchangeable search modes.
Which input starts a Douyin `search` request?
Search term for the video search action, passed as a string (for example, "latte art"). Used specifically for finding videos, not user nicknames or video IDs. Send it as keyword inside params.
Which fields can Douyin `search` return?
Its declared schema includes text, media_type, like_count, and comment_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Douyin action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.