Douyin Fetch User Live Videos By Room ID V2
Retrieve live-stream data for a specified live room (V2). Input: room_id is required and must be supplied as a string containing the live room ID, for example "7462723839303093032". Supply a room ID, not a user ID. Result: The response contains live-stream data in data, which may be null. The detailed structure of that data is not specified. Important: If modify_time is returned, it is the room's last update time, described as equivalent to the broadcast start time. It keeps its last value after the stream ends rather than resetting to zero; do not use this field alone to determine whether the room is currently live.
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 |
|---|---|---|---|---|
room_id | string | Yes | 直播间room_id/Room room_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_user_live_videos_by_room_id_v2' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"room_id": "7706702052180937522"
}
}'{
"code": 200,
"data": {
"data": {
"create_time": 0,
"dynamic_cover_dict": {},
"dynamic_cover_uri": "",
"extra": {
"create_scene": "",
"geo_block": 0,
"is_sandbox": false,
"is_virtual_anchor": false,
"limit_appid": "",
"limit_strategy": 0
},
"id": 7706702052180937522,
"title": "辽宁学什么技术#PLC#机器人"
}
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_user_live_videos_by_room_id_v2_api_v1_douyin_web_fetch_user_live_videos_by_room_id_v2_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "4768e521-07b8-4ff1-bb6e-79fab1d707b2"
}This example shows part of the response. Copied content is valid JSON.

