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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sec_uid | string | Yes | 用户sec_uid/User sec_uid | — |
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_sec_uid' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"sec_uid": "MS4wLjABAAAAePhr9XGmGokc2XGCYzRq7kQFv7JyzOlfZ8hThXYhBgE"
}
}'{
"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.

