YouTube Scraper API

发送一个 YouTube URL，即可获得结构化的 JSON 返回结果。Bright Data YouTube Scraper API 会处理代理、验证码和解析，让你专注于自己的数据管道。

初次使用 Bright Data？创建免费账户，即可每月获得 5,000 个免费积分，无需信用卡。这相当于最多 5,000 条 YouTube 记录，可供你开始抓取。请参阅免费套餐。

工作原理

你向 Bright Data YouTube Scraper API 发送一个或多个 YouTube URL。Bright Data 负责处理采集基础设施，并返回干净、结构化的 JSON。

Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY

所有请求都使用 dataset_id 来指定数据类型（视频、频道或评论），并以 JSON、NDJSON 或 CSV 格式返回结果。

响应内容示例

Bright Data YouTube Scraper API 于 2026 年 9 月 6 日返回的单条记录（已裁剪为所示字段）。可在快速开始中亲自发送该请求。

{
  "subscribers": 516000000,
  "url": "https://www.youtube.com/@mrbeast",
  "handle": "@MrBeast",
  "handle_md5": "dd748d5dfc88b91ea388429c3c685874",
  "banner_img": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-...",
  "profile_image": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
  "name": "MrBeast",
  "Description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000...",
  "videos_count": 1000,
  "created_date": "2012-02-19T00:00:00.000Z"
}

支持的数据类型

视频

标题、播放量、点赞数、描述、时长和缩略图。可按关键词、话题标签或探索来发现视频。

频道

订阅人数、视频数、描述和验证状态。可按关键词发现频道。

任何视频的评论文本、点赞数、回复和评论者详情。

请求方式

Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。

方式	端点	适用场景
同步	`/scrape`	实时查询，最多 20 个 URL
异步	`/trigger`	批量任务、20 个及以上 URL、生产环境管道

详见了解同步与异步请求。两个端点都接受两种请求体格式：本页所有示例使用的纯 JSON 数组，或带有 input 数组的对象。当您同时传入 custom_output_fields 或 limit_per_input（两个端点均支持），或在 /trigger 上传入 deliver 配置时，请使用对象格式。详见请求体。

功能与限制

功能	详情
输出格式	JSON、NDJSON、CSV
同步请求最大 URL 数	20
异步请求最大 URL 数	无限制，每个任务最多 1 GB 输入
数据新鲜度	实时（按需抓取）
投递方式	API 下载、webhook、Amazon S3、Snowflake、Azure、GCS（全部目标）
计费	按成功记录计费（查看价格）

常见问题

数据是实时采集的吗？

是的。每个请求都会触发一次实时采集。不存在缓存或过期数据。处理时间取决于目标网站状况和爬虫负载。Bright Data YouTube Scraper API 不公布固定的响应时间。同步请求最多等待 1 分钟，之后返回 HTTP 202 和 snapshot_id，并继续以异步方式采集。发现（discovery）请求始终以异步方式运行，耗时更长，具体取决于结果数量。

响应时间为什么会发生变化？

YouTube 会调整其页面的提供方式，Bright Data YouTube Scraper API 的采集器也会相应更新。即使成功率保持不变，采集器更新也可能改变一次采集所需的时间。对于生产环境的工作负载，请基于异步工作流或 Webhook 投递进行构建，这样较长的运行时间不会破坏集成。

URL 收集和发现有什么区别？

URL 收集会采集你提供的特定 YouTube 页面（例如频道 URL）。发现会查找与搜索条件匹配的 YouTube 内容（例如按关键词或话题标签查找视频）并采集结果。发现请求在两个端点上均可使用。在 /scrape 上通常会超过 1 分钟限制并返回 HTTP 202 和 snapshot_id，因此发现请求请使用异步 /trigger 端点。

与使用代理或 Web Unlocker API 抓取有何不同？

使用代理或 Web Unlocker API 抓取时，您仍需编写和维护自己的解析逻辑，并在目标网站页面结构变化时随时更新。Bright Data Scraper API 处理整个链路：代理轮换、反爬绕过与解析。您只需发送 URL 或关键词，即可获得干净的结构化 JSON，无需自建抓取基础设施或维护解析器。

后续步骤

快速开始

在 5 分钟内采集你的第一个 YouTube 频道。

端点

每个端点一个请求，附实际抓取的响应。

API 参考

端点规范、参数和响应模式。

开始使用

数据提取

网页搜索

AI 训练数据

代理网络

工作原理

响应内容示例

支持的数据类型

视频

频道

评论

请求方式

功能与限制

常见问题

数据是实时采集的吗？

响应时间为什么会发生变化？

URL 收集和发现有什么区别？

与使用代理或 Web Unlocker API 抓取有何不同？

后续步骤

快速开始

端点

API 参考

​工作原理

​响应内容示例

​支持的数据类型

视频

频道

评论

​请求方式

​功能与限制

​常见问题

​数据是实时采集的吗？

​响应时间为什么会发生变化？

​URL 收集和发现有什么区别？

​与使用代理或 Web Unlocker API 抓取有何不同？

​后续步骤

快速开始

端点

API 参考

工作原理

响应内容示例

支持的数据类型

请求方式

功能与限制

常见问题

数据是实时采集的吗？

响应时间为什么会发生变化？

URL 收集和发现有什么区别？

与使用代理或 Web Unlocker API 抓取有何不同？

后续步骤