Douyin On-screen video comments API

Read the danmaku (on-screen comments) of one Douyin video by url. Each one has text, video_time, video_time_seconds and like_count, and danmaku_count gives the total for the whole video, for $0.56 per 1,000 calls.

  • url takes a video ID, a video link, a short link or a whole share text.
  • One page is a stretch of up to 32 seconds of the video. Page until there is no next_page_token.
  • 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": "danmaku",
      "params": {
        "url": "https://www.douyin.com/video/7633646113853104116"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_uid": "",
          "text": "好厉害",
          "video_id": "7633646113853104116",
          "video_time": "00:00"
        },
        …
      ],
      "count": 824
    }
  3. 3Rows

    author_uidtextvideo_idvideo_time
    好厉害763364611385310411600:00
    小学生想吃763364611385310411600:00
  4. 4CSV

    douyin-danmaku-sample.csv id,text,video_id,video_time,video_time_seconds,like_count,author_uid,is_ad,danmaku_count,platform

A request with url goes in, and the danmaku of one stretch of the video come back; each row in results is one danmaku, listed as a field table and a CSV file.

What data you get

The table shows a real call for douyin.com/video/7633646113853104116, captured November 21, 2026 at 07:17 (UTC), that returned 824 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

idtextvideo_idvideo_timevideo_time_secondslike_countauthor_uidis_addanmaku_countplatform
好厉害763364611385310411600:0000false868douyin
小学生想吃763364611385310411600:0000false868douyin

Use cases

  • See when viewers react most

    Group the danmaku by video_time_seconds to see which stretch of the video has the densest comments.

  • Read what viewers say

    Read text to sum up how viewers react to a scene or a line.

  • Find the liked danmaku

    Sort by like_count to find the ones viewers agree with most.

  • Filter out ad danmaku

    is_ad says whether a danmaku is an ad, so filter on it before analysis.

Limits and gotchas

  • url is required. It can be an all-digit 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.
  • One page is a stretch of up to 32 seconds of the video, and the number of rows per page varies. Without page_token you get page 1.
  • To page, pass the next_page_token of the previous response back as page_token with the other parameters unchanged. A token works for 24 hours, and the last page has no next_page_token.
  • Page from the start until there is no next_page_token to read all danmaku of the video. Each page is one call.
  • Douyin does not give the author's nickname for a danmaku, only the numeric author_uid.
  • danmaku_count is the total for the whole video and is the same on every row. is_ad says whether a danmaku is an ad.

Pricing

You pay $0.000556 per call, not per row, and each page is one call. 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": "danmaku",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}'

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 danmaku, 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 On-screen video comments endpoint (douyin/danmaku).

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 danmaku, and put the parameters inside params.
- Required parameters:
  - url: The Douyin video whose danmaku you want: 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.
- Optional parameters:
  - page_token: Page token for danmaku. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours.
  - 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, text, video_id (ID of the video: on comments, the video…), video_time, video_time_seconds, like_count, author_uid (Numeric user ID of the author (on comme…), is_ad (Whether the post is an ad), danmaku_count.
- Example request body:
{
  "platform": "douyin",
  "action": "danmaku",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- 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.
actionbodystringYesdanmakuCapability identifier, fixed value.
urlbody.paramsstringYes-The Douyin video whose danmaku you want: 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.
page_tokenbody.paramsstringNo-Page token for danmaku. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours; the last page has no next_page_token. Each page is one stretch of up to 32 seconds of the video; to read the whole video, page until there is no next_page_token.
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

#
Captured November 21, 2026 at 07:17 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "douyin",  "action": "danmaku",  "results": [    {      "id": "•••",      "text": "好厉害",      "video_id": "7633646113853104116",      "video_time": "00:00",      "video_time_seconds": 0,      "like_count": 0,      "author_uid": "•••",      "is_ad": false,      "danmaku_count": 868,      "platform": "douyin"    },    {      "id": "•••",      "text": "小学生想吃",      "video_id": "7633646113853104116",      "video_time": "00:00",      "video_time_seconds": 0,      "like_count": 0,      "author_uid": "•••",      "is_ad": false,      "danmaku_count": 868,      "platform": "douyin"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 824,  "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.
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).
video_idID of the video: on comments, the video the comment belongs to; on post_history, the video you asked about.
video_timeKeeps the platform's own meaning
video_time_secondsKeeps the platform's own meaning
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
author_uidNumeric user ID of the author (on comments, of the commenter). author_id is the secUid; both identify the same person.
is_adWhether the post is an ad.
danmaku_countKeeps the platform's own meaning
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

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 danmaku API return?

One danmaku per row: id, text, video_id, video_time, video_time_seconds, like_count, author_uid, is_ad and danmaku_count.

How do I read all the danmaku of a video?

Leave out page_token for page 1, then pass next_page_token back unchanged, page by page, until the response has no next_page_token.

How do video_time and video_time_seconds differ?

Both say where in the video the danmaku appears. video_time is text in mm:ss. video_time_seconds is a number of seconds with decimals, which is easier to sort and group.

How much does it cost to read danmaku?

Each page is one call at $0.000556, or $0.56 per 1,000 calls, counted by calls and not by rows. 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