Douyin Posts in bulk API

Read several Douyin posts at once with urls; each post is one row with text, like_count, comment_count, share_count, collect_count and the author fields. Each item in urls is one call, at $0.56 per 1,000 calls.

  • input on each row is the item you sent, so you can match rows back.
  • Items that could not be read are not charged and are listed in missed in the response.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "posts_batch",
      "params": {
        "urls": [
          "https://www.douyin.com/video/<VIDEO_ID_A>",
          "<VIDEO_ID_B>"
        ]
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "text": string,
          "media_type": string,
          "video_url": string,
          "like_count": number
        },
        …
      ]
    }
  3. 3Rows

    textmedia_typevideo_urllike_count
    stringstringstringnumber
  4. 4CSV

    douyin-posts_batch-sample.csv id,url,text,media_type,video_url,like_count,comment_count,share_count,collect_count,author_name,author_id,author_douyin_id,author_bio,author_avatar_url,author_follower_count,author_following_count,author_like_count,author_video_count,author_is_verified,cover_image_url,video_width,video_height,video_bitrates,has_watermark,duration_sec,duration_seconds,hashtags,posted_at,title,music,location,image_urls,is_deleted,is_private,platform,input

A request with urls goes in, and one row per post comes back; input in results is the item you sent, listed as a field table and a CSV file.

What data you get

This endpoint has no public real sample yet. The table lists the fields, types and meanings that each row returns, with no values.

FieldTypeMeaning
idstringThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlstringLink to the record on the platform.
textstringBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
media_typestringMedia type: video, or image for image posts.
video_urlstringVideo playback URL (signed, expires; download promptly if you need to keep it). Null for image posts or when the source omits it.
like_countnumberLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countnumberComments. null means not disclosed, not 0.
share_countnumberShares. null means not disclosed, not 0.
collect_countnumberSaves or favorites. null means not disclosed, not 0.
author_namestringAuthor's display name.
author_idstringAuthor's unique ID on the platform.
author_douyin_idstringThe author's Douyin ID.
author_biostringThe author's profile bio (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_avatar_urlstringAuthor avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows.
author_follower_countnumberAuthor's follower count. null means not disclosed.
author_following_countnumberHow many accounts the author follows (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_like_countnumberTotal likes the author's profile has received (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript).
author_video_countnumberTotal number of posts on the author's profile (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_is_verifiedbooleanWhether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is).
cover_image_urlstringCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
video_widthnumberVideo frame width in pixels.
video_heightnumberVideo frame height in pixels.
video_bitratesarrayKeeps the platform's own meaning
has_watermarkbooleanKeeps the platform's own meaning
duration_secnumberVideo length in seconds.
duration_secondsnumberDuration in seconds. null for content that is not video or audio.
hashtagsarrayHashtags in the text, in order of appearance; absent when there are none.
posted_atstringPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
titlestringTitle. null when the platform has no titles (for example text-only posts).
musicobjectBackground track: id, title, author, is_original (original sound or not), duration_sec, cover_url and play_url (audio link, may expire). Absent when there is no music information.
location—Location description passed through as is; the format varies by platform.
image_urls—Array of image links in the platform's display order; absent when there are no images.
is_deletedbooleanTrue when the video has been deleted; present only when Douyin reports it on the row.
is_privatebooleanTrue when the video is visible only to its author (private); present only when Douyin reports it on the row.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
input—The entry from urls that this row answers, returned exactly as you passed it (posts_batch, profiles_batch, media_links). Use it to match rows to your entries.

Use cases

  • Refresh the engagement counts of a post library

    Put the video links from your library into urls, read like_count and comment_count on each row and match rows to your records with input.

  • Check that a set of videos is still there

    Read is_deleted and is_private to find posts that were deleted or are visible only to their owner.

  • Compare the authors of a set of videos

    Read author_name, author_follower_count and author_is_verified to see what size of accounts the videos come from.

  • Use it after link recognition

    When a pile of share texts holds several videos, first use resolve_links to split out each matched_text, then put them into urls; posts_batch itself accepts short links and whole share texts.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform overall authorization guide and EveryInfra posts_batch compare on access.

ComparedDouyin Open PlatformEveryInfra
How you call itThe documentation says API calls are made with the access_token to read the user's basic information and do other operations.You get no access_token first. The header carries your EveryInfra API key, and urls holds the posts to read.

The Douyin Open Platform documentation is in Chinese; the table shows a translation, checked against its overall authorization guide on 2026-11-22. The page shows no update date. The documentation has no description of reading any public posts in a batch, so only access is compared here. Official sources: Overall authorization guide

Limits and gotchas

  • urls is an array; the parameter reference says how many items one call takes; the same item can appear only once.
  • Each item can be a numeric video ID, a video link (https://www.douyin.com/video/<video ID>), a v.douyin.com short link or a whole share text that contains a short link.
  • Billing is per item, one call each; items that could not be read are not charged and are listed in missed in the response.
  • is_deleted is true when the post was deleted and is_private is true when only its owner can see it; the key exists only when Douyin marks it.
  • Engagement counts are the values at the moment of the read; use post_history to see how they change.
  • Synchronous calls only.

Pricing

Each item in urls counts as one call at $0.000556, so you pay by the number of items and not per field; items that could not be read are not charged. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>",
      "<VIDEO_ID_B>"
    ]
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for posts_batch, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Douyin Posts in bulk endpoint (douyin/posts_batch).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to posts_batch, and put the parameters inside params.
- Required parameters:
  - urls: The videos to read, as an array of up to 20 entries; each entry can appear only once. Each entry is a numeric video ID, a https://www.douyin.com/video/<video_id> link, a v.douyin.com short link, or a whole share text tha…
- Optional parameters:
  - limit: The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.
- Returns a list of records. Main fields of each record: id, url, text, media_type (Media type: video, or image for image p…), video_url (Video playback URL (signed, expires), like_count, comment_count, share_count, collect_count, author_name, author_id, author_douyin_id (The author's Douyin ID); 35 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>",
      "<VIDEO_ID_B>"
    ]
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- This endpoint runs synchronously only; do not add "mode": "async" to the body.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYesposts_batchCapability identifier, fixed value.
urlsbody.paramsarrayYes-The videos to read, as an array of up to 20 entries; each entry can appear only once. Each entry is a numeric video ID, a https://www.douyin.com/video/<video_id> link, a v.douyin.com short link, or a whole share text that contains a short link. Billed per video; videos not found are not charged. Rows carry input, the entry you passed.
limitbody.paramsinteger (1–)No-The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "douyin",  "action": "posts_batch",  "results": [    {      "id": …,      "url": …,      "text": …,      "media_type": …,      "video_url": …,      "like_count": …,      "comment_count": …,      "share_count": …,      "collect_count": …,      "author_name": …,      "author_id": …,      "author_douyin_id": …,      "author_bio": …,      "author_avatar_url": …,      "author_follower_count": …,      "author_following_count": …,      "author_like_count": …,      "author_video_count": …,      "author_is_verified": …,      "cover_image_url": …,      "video_width": …,      "video_height": …,      "video_bitrates": …,      "has_watermark": …,      "duration_sec": …,      "duration_seconds": …,      "hashtags": …,      "posted_at": …,      "title": …,      "music": …,      "location": …,      "image_urls": …,      "is_deleted": …,      "is_private": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the platform.
textBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
media_typeMedia type: video, or image for image posts.
video_urlVideo playback URL (signed, expires; download promptly if you need to keep it). Null for image posts or when the source omits it.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
share_countShares. null means not disclosed, not 0.
collect_countSaves or favorites. null means not disclosed, not 0.
author_nameAuthor's display name.
author_idAuthor's unique ID on the platform.
author_douyin_idThe author's Douyin ID.
author_bioThe author's profile bio (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_avatar_urlAuthor avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows.
author_follower_countAuthor's follower count. null means not disclosed.
author_following_countHow many accounts the author follows (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_like_countTotal likes the author's profile has received (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript).
author_video_countTotal number of posts on the author's profile (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows).
author_is_verifiedWhether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is).
cover_image_urlCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
video_widthVideo frame width in pixels.
video_heightVideo frame height in pixels.
video_bitratesKeeps the platform's own meaning
has_watermarkKeeps the platform's own meaning
duration_secVideo length in seconds.
duration_secondsDuration in seconds. null for content that is not video or audio.
hashtagsHashtags in the text, in order of appearance; absent when there are none.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
titleTitle. null when the platform has no titles (for example text-only posts).
musicBackground track: id, title, author, is_original (original sound or not), duration_sec, cover_url and play_url (audio link, may expire). Absent when there is no music information.
locationLocation description passed through as is; the format varies by platform.
image_urlsArray of image links in the platform's display order; absent when there are no images.
is_deletedTrue when the video has been deleted; present only when Douyin reports it on the row.
is_privateTrue when the video is visible only to its author (private); present only when Douyin reports it on the row.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
inputThe entry from urls that this row answers, returned exactly as you passed it (posts_batch, profiles_batch, media_links). Use it to match rows to your entries.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Douyin batch posts API return?

One row for each post that was read: id, url, text, media_type, like_count, comment_count, share_count, collect_count, the author fields, hashtags, posted_at, is_deleted, is_private and more, plus input.

How do I match a result to the item I sent?

input on each row is the item you sent, unchanged. Match on it.

What if some items could not be read?

Check missed in the response. Those items were not read and are not charged; you can request them again on their own.

How is a batch of posts billed?

Each item in urls is one call at $0.000556, or $0.56 per 1,000 calls. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy