Douyin Fetch Live Im Fetch
Retrieve danmaku parameters for a Douyin live room. Inputs: - room_id (required string): The live room ID. - user_unique_id (required string): The user unique ID. Returns a response with the danmaku parameter data in data, along with response status information. The detailed parameter-data structure is not specified. This is a parameter lookup, not a live chat stream or chat-history retrieval tool.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Charged per call at 2.07 credits per call. Charges are per query. A successful query is billed even if it returns no results.
This tool retrieves live room comment parameters; it does not provide a live comment stream or chat history.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
room_id | string | Yes | 直播间号/Live room id | — |
user_unique_id | string | Yes | 用户唯一ID/User unique ID | — |
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_live_im_fetch' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"room_id": "7382517534467115826",
"user_unique_id": "7382524529011246630"
}
}'{
"code": 200,
"data": {
"data": [
{
"common": {
"create_time": 1793785364793,
"is_show_msg": true,
"method": "WebcastRoomMessage",
"msg_id": 7704249477893550664,
"play_time": 0,
"room_id": 7382517534467115826
},
"content": "欢迎来到直播间!抖音严禁未成年人直播或礼物消费。严禁违法违规、低俗色情、吸烟酗酒、人身伤害等直播内容。理性消费,如主播在直播中以不当方式诱导消费,请谨慎辨别。切勿私下交易,以防人身财产损失,谨防网络诈骗。"
}
],
"extra": {
"cursor": "d-1_u-1_h-1_t-1793785364815_r-1",
"fetch_interval": 1000,
"live_cursor": "u-1_d-1",
"now": 1793785364815
},
"internal_ext": "internal_src:dim|wss_push_room_id:7382517534467115826|wss_push_did:7571816300415108650|first_req_ms:1793785364651|fetch_time:1793785364815|seq:1|wss_info:0-0-0-0",
"status_code": 0
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_live_im_fetch_api_v1_douyin_web_fetch_live_im_fetch_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

