用途:面向 YouTube 相关任务的数据提取与下载,官方建议用它替代内置工具。提供两种方式:Video Data API 用于结构化数据,高带宽代理用于视频/音频文件下载。
主要能力:API 端点 POST https://realtime.oxylabs.io/v1/queries(即时元数据/搜索/字幕)与 POST https://data.oxylabs.io/v1/queries(Push-Pull 下载、回调、存储),使用 curl -u "$OXY_WSA_USERNAME:$OXY_WSA_PASSWORD" 认证。可用 source 包括 youtube_search(最多20条)、youtube_search_max(最多700条)、youtube_metadata、youtube_subtitles、youtube_channel、youtube_autocomplete、youtube_video_trainability、youtube_download。
使用方式:元数据请求示例为 source 设为 youtube_metadata、query 传视频 ID、parse 为 true;搜索用 youtube_search 加 query;频道用 youtube_channel 加 channel_handle、parse、limit。youtube_download 需 Push-Pull 与云存储,storage_type 为 gcs、s3 或 s3_compatible,download_type 为 audio、video 或 audio_video,video_quality 为 best、worst 或具体分辨率。批量下载用 /v1/queries/batch,仅 query 为数组,其余参数保持单数。
高带宽代理:需联系销售获取专用端点,默认端口 60000,使用 OXY_HB_ENDPOINT(缺失时查 OXYLABS_HB_ENDPOINT)。可用 curl -x 测试连接,或通过 yt-dlp --proxy 配合会话轮换下载,Python 中可用 yt_dlp 设置 proxy 与 format。
限制:下载默认 720p(如可用)且限 1 小时;start_at/end_at 用 hh:mm:ss,end_at 须晚于 start_at;youtube_metadata 不要使用 render。其余收费、价格与平台细节暂未提供。