Douyin Fetch User Live Videos By Sec Uid

2.07 credits/call
ae_douyin_fetch_user_live_videos_by_sec_uid

Retrieve live-stream data for a specific Douyin user. Input: sec_uid is a required string identifying the user. It is also called sec_user_id and can be found in the user's profile link; pass the identifier itself. Returns: A response containing live-stream data in data, along with response status and message information. The data value may be null, and its detailed structure is not specified; particular playback links or live-status fields are not guaranteed. This tool is for live-stream data, not posted videos or live recordings.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.

Queries live-stream data for a specified Douyin user. Provide the user's sec_uid identifier itself. Returned data may be null and is not guaranteed to include a particular playback URL or live-status field.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
sec_uidstringYes用户sec_uid/User sec_uid—

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_sec_uid' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "sec_uid": "MS4wLjABAAAAePhr9XGmGokc2XGCYzRq7kQFv7JyzOlfZ8hThXYhBgE"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "data": {
      "avatar_large": {
        "avg_color": "",
        "flex_setting_list": [],
        "height": 0,
        "image_type": 0,
        "is_animated": false,
        "open_web_url": ""
      },
      "avatar_medium": {
        "avg_color": "",
        "flex_setting_list": [],
        "height": 0,
        "image_type": 0,
        "is_animated": false,
        "open_web_url": ""
      },
      "avatar_thumb": {
        "avg_color": "",
        "flex_setting_list": [],
        "height": 0,
        "image_type": 0,
        "is_animated": false,
        "open_web_url": ""
      },
      "birthday": 0,
      "gender": 1,
      "id": 85020314682
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_user_live_videos_by_sec_uid_api_v1_douyin_web_fetch_user_live_videos_by_sec_uid_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.