YouTube Video & Shorts Downloader

Inspect, clip, enhance, and download YouTube videos and Shorts with durable jobs, subtitles, chapters, thumbnails, and resumable delivery.

原始信息汇总

YouTube Video & Shorts Downloader API 数据集概述

基本信息

• 类别：视频、图像
• 提供方：PDPRO
• 服务等级：100% Service Level
• 平均延迟：388ms
• 订阅方案：提供 BASIC（免费）、PRO（$15.00/月）、ULTRA（$49.00/月）、MEGA（$149.00/月）四种套餐

核心功能

该API支持检查、剪辑、增强和下载符合条件的公开YouTube视频和Shorts，输出格式支持MP4和WebM，分辨率范围从144p到4K（取决于源视频质量）。主要功能包括：

• 统一工作流程：普通视频和Shorts使用同一套处理流程
• 时间范围剪辑：支持指定起止时间进行视频片段提取
• 章节下载：支持按精确章节标题下载
• 字幕嵌入：支持手动或自动软字幕嵌入，用户可在播放器中自由选择或隐藏
• 元数据增强：可嵌入公开源元数据、MP4封面图和章节标记
• 多格式输出控制：支持容器格式、质量等级、字幕语言等配置

推荐使用流程

1. 调用 GET /api/v2/youtube/video/info?url=... 获取视频信息（章节、字幕、缩略图等）
2. 发送 POST /api/v2/youtube/video/jobs 创建下载任务，附带幂等性键（Idempotency-Key）
3. 通过回调URL（callbackUrl）或长轮询（GET /api/v2/jobs/{jobId}?waitSeconds=25）获取任务状态
4. 任务完成后，通过 GET /api/v2/jobs/{jobId}/result-url 或可续传下载端点获取结果

批处理能力

支持批量创建任务（POST /api/v2/youtube/video/jobs/batch），单次可提交1至10个任务，每个任务独立验证并支持相同的输出控制参数。

数据安全与限制

• 数据安全：源码检查响应使用明确的白名单机制，不会返回上游媒体URL、请求头、Cookie、代理配置或提取器内部信息
• 最大时长：源视频最长支持3小时
• 合法使用：仅允许处理公开、符合条件的媒体；直播、私密、已删除、受限或年龄限制媒体可能失败。仅可处理您拥有、有权处理或依法可使用的媒体内容
• 关联声明：该服务与YouTube或Google无关联

可靠性特性

• 视频任务持久化在MongoDB中，支持重启和部署恢复
• 自动重试临时错误，数据库驱动的去重保护
• 支持HTTP Range、HTTP 206和HEAD请求的可续传下载
• 签名终端Webhook支持重试和手动重放
• 每客户队列和工作容量公平分配
• 重复任务结果可复用，提供短期有效的签名结果URL

相关服务链接

• 状态页面：https://api-youtubemp3.paulius.pro/status
• 交互式文档：https://api-youtubemp3.paulius.pro/docs
• 视频OpenAPI文档：https://api-youtubemp3.paulius.pro/api/v2/youtube/video/openapi.json
• 服务条款：https://api-youtubemp3.paulius.pro/terms