Douyin Fetch Multi Video High Quality Play URL
## Purpose Retrieve highest-quality playback links for up to 50 Douyin videos in one request. “Original-upload quality” means the quality of the creator's uploaded video, not an upscaled or enhanced version. Useful for video editing, archiving, and other workflows that need high-quality source links. ## Inputs - `request_body`: Required request object. - `request_body.aweme_ids`: Video IDs as a comma-separated string, such as `"7512756548356492544,7448118827402972455"`. Supply no more than 50 IDs, rather than an array or share URLs. - `request_body.region`: Optional ISO country code, such as `CN`, `US`, or `HK`, for the request's egress region. The region can affect the CDN links returned; mainland China users can use `CN` for potentially faster downloads. ## Results The response data includes `total` (total count), `success_count` (successful retrievals), `failed_count` (failed retrievals), and `videos` (per-video results). Each video entry includes: - `video_id`: Video ID. - `original_video_url`: Highest-quality, original-upload-quality playback link. - `file_size` and `file_size_in_mb`: File size in bytes and MB, respectively. - `content_type`: Content type. - `success`: Whether that video's retrieval succeeded. - `error`: Error information if retrieval failed. Check individual success flags and errors because a batch may contain failures. Larger batches can take longer, so allow additional waiting time. The tool returns links and metadata, not downloaded video files.
Pricing
| Condition | Charge |
|---|---|
| Each call | 516.35 credits/call |
516.35 credits/call Charges are per query. A successful query is billed even if it returns no results.
Batch video URL retrieval is charged per call, with the entire batch billed as one call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 批量获取抖音视频最高画质(原始上传画质)播放链接的请求对象;aweme_ids 为英文逗号分隔的视频作品 ID 字符串,最多 50 个;region 为可选的请求出口地区,使用 ISO 国家代码(如 CN、US、HK),用于影响返回的区域 CDN 链接。 / Request object for retrieving highest-quality (original-upload-quality) playback URLs for a batch of Douyin videos. aweme_ids is a comma-separated string of up to 50 video IDs; region is an optional ISO country code (such as CN, US, or HK) for the request's egress region, influencing the regional CDN URLs returned. | — |
request_body.region | string | null | No | 可选,请求出口地区(ISO 国家代码,如 CN/US/HK)。抖音根据请求 IP 返回对应区域 CDN,国内用户传 'CN' 可获得国内 CDN 链接以加快下载速度 / Optional, ISO country code (e.g. CN). Pass 'CN' for users in mainland China to get China-region CDN URLs for faster download. | — |
request_body.aweme_ids | string | No | 作品id列表,用逗号分隔,最多50个/Video id list, separated by commas, up to 50 | 7512756548356492544,7448118827402972455,7126745726494821640 |
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_multi_video_high_quality_play_url' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"aweme_ids": "7694512500309511475,7568831568526069043",
"region": "CN"
}
}
}'{
"code": 200,
"data": {
"failed_count": 1,
"success_count": 1,
"total": 2,
"videos": [
{
"error": "无法获取原画质视频链接",
"success": false,
"video_id": "7694512500309511475"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_multi_video_high_quality_play_url_api_v1_douyin_web_fetch_multi_video_high_quality_play_url_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

