Douyin Fetch One Video Danmaku
Retrieve danmaku (on-screen bullet comments) for a single Douyin video. Required inputs: - item_id (string): The video ID. - duration (integer): The video's total duration. - start_time (integer): The start time for the requested danmaku range. - end_time (integer): The end time for the requested danmaku range. Returns a response containing video danmaku data in data, along with status and response metadata. The structure of individual danmaku records is not specified in the documented response. These are on-screen bullet comments, not ordinary comment threads. The time units are not specified in the documentation; confirm them before preparing the inputs. Documented input example: item_id="7355433624046472498", duration=15134, start_time=0, end_time=15133.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
item_id | string | Yes | 作品id/Video id | — |
duration | integer | Yes | 视频总时长/Video total duration | — |
end_time | integer | Yes | 结束时间/End time | — |
start_time | integer | Yes | 开始时间/Start time | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_one_video_danmaku' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"duration": 22,
"end_time": 22000,
"item_id": "7705802545314532595",
"start_time": 0
}
}'{
"code": 200,
"data": {
"danmaku_list": [
{
"danmaku_id": "7706513061632475955",
"danmaku_type": 0,
"digg_count": 0,
"digg_type": 0,
"from_copy": false,
"item_id": "7705802545314532595"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_one_video_danmaku_api_v1_douyin_web_fetch_one_video_danmaku_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "9b8e0419-dcf2-4a2e-bd78-843e8ea72bfb"
}This example shows part of the response. Copied content is valid JSON.

