Douyin Fetch Video High Quality Play URL
Get a Douyin video's highest-quality playback link at its original upload quality, along with video metadata. Useful for high-quality viewing, editing, and archiving. Inputs: - aweme_id: Video ID; use this when available. - share_url: Douyin share link to use when the video ID is unavailable. It can be omitted if aweme_id is supplied. - region: Optional ISO country code, such as CN, US, or HK, used to request a regional CDN link. CN is recommended for viewers in mainland China to help improve download speed. If omitted, the default request location is used. The documented result includes video_id (video identifier), original_video_url (highest-quality original-upload playback URL), and video_data (metadata such as duration and size). This retrieves a link rather than downloading the video file. If the link does not play online, try downloading the video and playing it locally.
Pricing
| Condition | Charge |
|---|---|
| Each call | 10.33 credits/call |
10.33 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
region | string | No | 可选,请求出口地区(ISO 国家代码,如 CN/US/HK),国内用户传 CN 可拿到国内 CDN 域名以加快下载速度 / Optional, ISO country code (e.g. CN/US/HK). Pass CN to get China-region CDN URLs for faster download in mainland China. | — |
aweme_id | string | No | 作品id/Video id | — |
share_url | string | No | 可选,分享链接/Optional, share link | — |
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_high_quality_play_url' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"aweme_id": "7680892879161642282",
"region": "CN"
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_video_high_quality_play_url_api_v1_douyin_web_fetch_video_high_quality_play_url_get",
"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": {
"aweme_id": "7680892879161642282",
"region": "CN"
}
}
}This example shows part of the response. Copied content is valid JSON.

