Douyin Fetch Video Detail
Retrieve details for a Douyin video using its ID, video link, or share text. Inputs: - request_body (required): Object containing the lookup inputs. - request_body.video (required string): Video ID, video link, or share text, such as "7651708301280906538" or text containing a v.douyin.com link. - request_body.cookie (optional string or null): Your www.douyin.com web Cookie. Returns: A response whose data field contains the matching video data and may be null. The detailed structure of the video data is not specified. This tool looks up a specific video rather than searching by keyword.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
The fixed fee is 2.07 credits per 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 |
|---|---|---|---|---|
request_body | object | Yes | 用于获取抖音视频详情的请求体对象,包含指定视频 ID、视频链接或分享文本的 video 字段,以及可选的用户 www.douyin.com 网页版 Cookie 字段 cookie。/ Request body for retrieving Douyin video details, containing video for the video ID, video link, or share text, and optional cookie for the user's www.douyin.com web Cookie. | — |
request_body.video | string | Yes | 视频ID 或 视频链接/分享文本/Video ID, or share link/text. 例/e.g. "7651708301280906538" 或/or 含 v.douyin.com 链接的分享文案 | — |
request_body.cookie | string | null | No | 用户 www.douyin.com 网页版 Cookie/User www.douyin.com web Cookie | — |
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_video_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"video": "4- 长按复制此条消息,打开抖音搜索,查看TA的更多作品。 https://v.douyin.com/qiM1CjCQabg/ 1@0.com :2pm"
}
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/fetch_video_detail_api_v1_douyin_douplus_fetch_video_detail_post",
"headers": {},
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"params": {}
}
}This example shows part of the response. Copied content is valid JSON.

