Douyin Fetch Multi Video High Quality Play URL

516.35 credits/call
ae_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.

VideoSocial
516.35 credits/call

Pricing

516.35 credits/call
ConditionCharge
Each call516.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes批量获取抖音视频最高画质(原始上传画质)播放链接的请求对象;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.regionstring | nullNo可选,请求出口地区(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_idsstringNo作品id列表,用逗号分隔,最多50个/Video id list, separated by commas, up to 507512756548356492544,7448118827402972455,7126745726494821640

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_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"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.