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.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
search

Search

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.

keywordpublish_time, sortSync deliveryCatalog 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 requestsid · 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
profile

Profiles

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_idsinceSync delivery$0.56 per 1,000 requestsuser_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · platform
user_posts

Posts by user

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_idsinceSync deliveryCatalog 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 requestsid · 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
video

Video details

Retrieve a public video from Douyin. Accepts these parameters: url. Returns these fields: posted_at, text, author_follower_count, and collect_count.

urlSync delivery$0.56 per 1,000 requestsid · 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
comments

Comments

Retrieve public comments from Douyin. Accepts these parameters: url. Returns these fields: like_count, author_name, reply_count, and posted_at.

urlSync deliveryCatalog 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 requestsid · text · like_count · reply_count · author_name · author_id · ip_location · liked_by_author · is_reply · reply_to_id · posted_at · platform
trending

Trending

Retrieve current trends from Douyin. Accepts these parameters: boards. Returns these fields: board, image_url, video_count, and event_time.

boardsSync deliveryCatalog 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 requestsrank · keyword · hot_value · video_count · board · image_url · event_time · platform
transcript

Transcript

Retrieve a video transcript from Douyin. Accepts these parameters: url. Returns these fields: like_count, posted_at, author_follower_count, and author_name.

urlSync delivery$0.56 per 1,000 requestsid · 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), and half_year (last 6 months).
sortOptional
Sorts video search results. Allowed values are relevance (default), newest for the latest publish date, and most_liked for highest likes. Supports legacy compatibility aliases general (mapped to relevance) and latest (mapped to newest).

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 secUid string (typically starting with MS4w), not a nickname or short numerical Douyin ID. Used to identify accounts for profile and user_posts actions; can be obtained from an author_id field 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 profile and user_posts actions using the YYYY-MM-DD format. 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 secUid string (typically starting with MS4w), not a nickname or short numerical Douyin ID. Used to identify accounts for profile and user_posts actions; can be obtained from an author_id field 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 profile and user_posts actions using the YYYY-MM-DD format. 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 in video, comments in comments, or audio transcripts in transcript. 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 in video, comments in comments, or audio transcripts in transcript. 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.

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 in video, comments in comments, or audio transcripts in transcript. Do not pass user profile or search page URLs.

How to use the Douyin API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
  4. 04Store the structured response fields needed by your application.
douyin_search.sh
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.