跳转到主要内容
Decodo 视频下载器（target: youtube_video）可用于下载并保存指定的 YouTube 视频到 S3 兼容存储中。
要获取访问权限，请联系我们的销售团队

​
youtube_video

  • youtube_video 目标仅支持异步和批量集成。
  • 批量 youtube_video 请求限制为每次请求 100 个视频。
  • 支持下载 12 小时或更短的视频。
  • 下载时间限制为 10 小时。
将 YouTube 视频下载到 Amazon S3 兼容的存储位置。
参数类型必需描述默认值示例
targetstring✅选择 YouTube 下载所需。youtube_video
querystring✅YouTube 视频 ID。dFu9aKJoqGg
upload_urlstring✅S3 兼容存储位置的 URL。https://<key>:<secreat>@<bucket-url>
mediastring选择无声音的 video、audio 或包含两者的 audio_video。audio_video
qualitystring视频或音频的质量。有效选项：best、worst、480、720、1080、1440、2160。720
# 将 'TOKEN VALUE' 更新为您的授权令牌
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic TOKEN VALUE' \
        --header 'Content-Type: application/json' \
        --data '
    {
      "target": "youtube_video",
      "query": "PFRn5zKJTD8",
      "upload_url": "https://storage_username:[email protected]/video-folder"
    }
'

​
传送到 S3

您可以通过 upload_url 参数提供一些参数，将视频直接下载到您的 S3 存储桶中。在以下步骤中，我们将把示例视频上传到新存储桶。
如果可以的话，我们建议为视频下载创建一个新存储桶。也就是说，以下步骤也适用于现有存储桶。
要开始下载视频：
  1. 使用默认设置和权限创建新的 S3 存储桶。
  2. 创建新的 IAM 用户。
  3. 在 IAM 用户上为您的存储桶附加 PutObject 权限：
    1. 添加内联策略：
    2. 在服务下，选择 S3。
    3. 在操作下：
      1. 需要将以下权限添加到存储桶：
        • GetBucketLocation
      2. 需要将以下权限添加到存储桶的文件夹：
        • PutObject
        • PutObjectAcl
    4. 在资源下，选择特定，点击添加 ARN，添加您的存储桶名称和视频文件夹名称：
    5. 您的最终策略声明应如下所示： 
      {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Sid": "Statement01",
			"Effect": "Allow",
			"Action": "s3:GetBucketLocation"
			"Resource": "arn:aws:s3:::your-bucket"
		},
		{
			"Sid": "Statement02",
			"Effect": "Allow",
			"Action": [
				"s3:PutObject",
				"s3:PutObjectAcl"
			],
			"Resource": "arn:aws:s3:::your-bucket/*"
		}
	]
}
  4. 为该用户生成访问密钥和密钥。
    1. 当询问用例时，选择其他。
    发送到 Scraper API 的访问密钥不能包含任何可能与 upload_url 参数冲突的非 URI 转义字符，例如 / 或 @。如果 AWS 生成的密钥包含此类字符，请重新生成您的密钥。
  5. 使用以下示例参数调用 Scraper API：
{
    "target": "youtube_video",
    "query": "PFRn5zKJTD8",
    "upload_url": "https://access_key:[email protected]/video-folder"
}
注意事项：
  • access_key 和 access_secret 从第 4 步生成。
  • us-west-2 用作示例区域，您的 AWS 区域可能不同。
  • 必须提供 /video-folder。

​
S3 兼容提供商

以下是一些 S3 兼容提供商，它们也可以与此目标开箱即用：

​
示例请求

# 将 'TOKEN VALUE' 更新为您的授权令牌
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic Authentication Token' \
        --header 'Content-Type: application/json' \
        --data '
    {
      "target": "youtube_video",
      "query": "PFRn5zKJTD8",
      "upload_url": "https://storage_username:[email protected]/video-folder"
    }
'
成功排队的作业将返回类似以下的响应： 
{
    "target": "youtube_video",
    "query": "PFRn5zKJTD8",
    "page_from": 1,
    "limit": 10,
    "geo": null,
    "device_type": "desktop",
    "headless": null,
    "parse": false,
    "locale": null,
    "domain": "com",
    "output_schema": null,
    "created_at": "2025-07-01 11:09:53",
    "id": "7345770621134969857",
    "status": "pending",
    "content_encoding": "utf-8",
    "updated_at": "2025-07-01 11:09:53",
    "force_headers": false,
    "force_cookies": false,
    "headers_cookies_policy": false,
    "media": "audio_video",
    "quality": "720"
}

​
访问地理限制视频

Scraper API 会尝试自动选择下载地理限制视频的最佳位置。但是，YouTube 视频不会公开有关给定视频限制到哪个地理位置的信息，因此，Scraper API 可能会在固定次数的尝试后失败。可能需要手动重试抓取请求。

​
监控进度

可以通过 /v2/task/:id/results 端点检查排队视频下载的状态（您可以在创建任务后在响应正文中找到 id）：
  • HTTP 状态码 204 表示下载仍在处理中。
  • HTTP 状态码 200 表示下载已完成，并已尝试上传到您的存储目录。
Scraper API 目前不支持：
  • 显示下载进度（已完成/剩余百分比）
  • 指示上传到 upload_url 失败时（无效凭据、找不到存储桶等）
即使上传到 upload_url 失败，请求仍会收费 - 我们建议先使用小视频进行测试。

支持

需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。
您也可以随时通过电子邮件 support@decodo.com 联系我们。

反馈

找不到您要找的内容？请求一篇文章！
有反馈意见？分享您对我们如何改进的想法。