YouTube Data API v3 logo

YouTube Data API v3

YouTube Data API v3

正常免费analyticsGoogle

YouTube Data API v3 让应用查询频道、视频、播放列表与评论,是 YouTube 集成与分析的标准入口。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

公开数据只需 API key 即可调用,零授权门槛

先注意什么

默认配额 10000 units/天,搜索请求成本高(100 units/次)容易耗尽

第一步先查

在 console.cloud.google.com 启用 YouTube Data API v3 并生成 API key(只读公开数据)。需要 OAuth 才能操作用户自己的频道(如 video upload、playlist edit)。

认证
oauth
CORS
不支持
HTTPS
注册
需要
延迟
40 ms
协议
REST
计费
free

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 40ms
01

关于这个 API

YouTube Data API v3 是访问 YouTube 公开元数据的标准接口:视频、频道、播放列表、评论、字幕。绝大多数读取操作(如查频道粉丝、视频播放数、搜索视频)用 API key 就能完成,不需要 OAuth,对做趋势分析和聚合站尤其友好。

配额是这个 API 的核心约束。每个请求按"quota units"扣费——videos.list 1 unit、search.list 100 units、videos.insert 1600 units。默认每天 10000 units,单个项目最容易被烧光的是 Search 端点。要规模化使用通常需要走 quota extension 申请,Google 会评估你的用途。上传视频或操作用户频道时必须用 OAuth 并取 youtube.upload 等 scope。

02

你可以做什么

  • 1搭建 YouTube 视频聚合器或趋势监控
  • 2查询频道与视频统计做分析报表
  • 3为创作者工具读写自己频道内容
  • 4把站外视频导入 YouTube 嵌入位
  • 5抓取评论做情感或趋势分析
03

优劣对比

优点

  • 公开数据只需 API key 即可调用,零授权门槛
  • Search、Videos、Channels、Comments 端点覆盖大多数需求
  • CC BY 视频信息附带,便于合规使用

注意事项

  • 默认配额 10000 units/天,搜索请求成本高(100 units/次)容易耗尽
  • 上传视频需要 OAuth 且配额受限
  • 某些字段(如完整观看量趋势)需走 YouTube Analytics API
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://google.com/<endpoint> \
  -H "Authorization: Bearer $ACCESS_TOKEN"
05

快速开始

在 console.cloud.google.com 启用 YouTube Data API v3 并生成 API key(只读公开数据)。需要 OAuth 才能操作用户自己的频道(如 video upload、playlist edit)。

06

常见问题

只查公开数据需要 OAuth 吗?+

不需要,API key 即可。OAuth 仅用于操作用户自己的频道。

为什么配额一下就用完了?+

search.list 单次扣 100 units,默认每天 10000 units。设计时尽量缓存搜索结果或换用 videos.list 按 ID 批量查。

如何提升配额?+

在 Cloud Console 的 quota 页面申请 extension,描述用途、流量预估、用户规模。Google 人工审核。

中国能访问吗?+

API 域名 googleapis.com 在中国大陆受限,需要科学上网或部署在境外节点。

07

技术细节

CORS: NoHTTPS: Yes注册: Yes开源: No
认证方式
oauth
计费
free
协议
REST
SDK
python, javascript, java, go, ruby
响应时间
40 ms
上次巡检
2026/5/12 07:37:37
08

接口端点

从 OpenAPI spec 自动解析。显示 12 / 76 个未弃用端点。

POST
/youtube/v3/abuseReportsabuseReports
part:query*
GET
/youtube/v3/activitiesactivities
part:query*channelId:queryhome:querymaxResults:querymine:query+4 更多
DELETE
/youtube/v3/captionscaptions
id:query*onBehalfOf:queryonBehalfOfContentOwner:query
GET
/youtube/v3/captionscaptions
part:query*videoId:query*id:queryonBehalfOf:queryonBehalfOfContentOwner:query
POST
/youtube/v3/captionscaptions
part:query*onBehalfOf:queryonBehalfOfContentOwner:querysync:query
PUT
/youtube/v3/captionscaptions
part:query*onBehalfOf:queryonBehalfOfContentOwner:querysync:query
GET
/youtube/v3/captions/{id}captions
id:path*onBehalfOf:queryonBehalfOfContentOwner:querytfmt:querytlang:query
POST
/youtube/v3/channelBanners/insertchannelBanners
channelId:queryonBehalfOfContentOwner:queryonBehalfOfContentOwnerChannel:query
GET
/youtube/v3/channelschannels
part:query*categoryId:queryforUsername:queryhl:queryid:query+6 更多
PUT
/youtube/v3/channelschannels
part:query*onBehalfOfContentOwner:query
DELETE
/youtube/v3/channelSectionschannelSections
id:query*onBehalfOfContentOwner:query
GET
/youtube/v3/channelSectionschannelSections
part:query*channelId:queryhl:queryid:querymine:query+1 更多

另有 64 个端点未显示,详见 OpenAPI spec。

09

标签

10

更多来自 Google 的 API