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 Use Douyin | 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 Use Douyin | 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 Use Douyin | 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 Call | 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 Use Douyin | 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 The object handled by Douyin | 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 Use Douyin | 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?
Use Douyin search to discover Douyin public results. Discovery returns Douyin video candidates matched to the supplied keyword. Douyin search reads publish_time, sort, and keyword, with posted_at, like_count, author_id, collect_count, view_count, author_douyin_id, author_name, platform, text, media_type, share_count, author_follower_count, region, comment_count, id, and url available in its response.
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?
Use Douyin profile to read one Douyin public record. Use Douyin account input with profile; Douyin then reads public record. Douyin profile takes since and user_id and yields ip_location, gender, is_verified, like_count, douyin_id, nickname, platform, user_id, avatar_url, video_count, follower_count, url, bio, and following_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?
Use Douyin user_posts to read public Douyin account posts. Use Douyin account input with user_posts; Douyin then reads account posts. Douyin user_posts takes since and user_id and yields posted_at, share_count, author_douyin_id, id, comment_count, collect_count, author_name, platform, author_id, text, media_type, region, like_count, view_count, url, and author_follower_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?
Call video to work with one public video from Douyin. Use Douyin video with url; Douyin then selects one public video. Video detail resolves one Douyin item and its available engagement fields. Call Douyin video with url; Douyin video exposes posted_at, text, author_follower_count, collect_count, author_id, like_count, author_name, author_douyin_id, comment_count, share_count, media_type, region, view_count, platform, url, and id.
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?
Use Douyin comments to read visible Douyin comments. Use Douyin comments with url; Douyin then selects object comments. Pass url to Douyin comments; returned objects expose id, like_count, author_name, reply_count, posted_at, is_reply, ip_location, reply_to_id, author_id, platform, text, and liked_by_author.
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?
The object handled by Douyin trending is the current trending sample. In this contract, invoke it without a required business field, using optional boards solely when the contract lists it. Douyin trending takes boards and yields board, image_url, video_count, platform, event_time, hot_value, keyword, and rank.
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?
Use Douyin transcript with url; Douyin then selects the available transcript. Missing segments in the available transcript must not be filled by inference. For Douyin transcript, supply url; results include like_count, posted_at, author_follower_count, author_name, url, play_count, share_count, collect_count, id, platform, text, comment_count, title, and author_avatar.
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.