Douyin Fetch User Live Videos By Room ID V2

2.07 credits/call
ae_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.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
room_idstringYes直播间room_id/Room room_id—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.