YouTube
BulkPublish
YouTube API
用你自己的代码发布、排期和管理 YouTube。一个 REST API 和一个密钥就能覆盖 YouTube 和你连接的其他所有网络,集成只需写一次。
YouTube API 涵盖的内容
下面的一切都属于已公开的 API,今天就能用于 YouTube。
| 功能 | 接口 |
|---|---|
| 创建、排期、更新和发布帖子 | POST /api/posts |
| 上传图片和视频 | POST /api/media |
| 查找队列中的下一个空闲时段 | GET /api/posts/queue-slot |
| 创建重复排期 | POST /api/schedules |
| 发布 RSS 源中的新内容 | POST /api/rss-feeds |
| 查询某个频道的 YouTube 播放列表 | GET /api/channels/{id}/options |
| 自动发布首条评论 | platformSpecific._firstComment |
| 读取每条帖子的数据 | GET /api/posts/{id}/metrics |
| 读取并回复已发布帖子下的评论 | GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply |
| 检查连接是否正常 | GET /api/channels/{id}/health |
| 查看套餐用量 | GET /api/quotas/usage |
可发布到 YouTube 的帖子类型
用 postTypeOverrides 选择类型。YouTube 不提供的类型会在排队之前就被拒绝。
| 内容类型 | 媒体 |
|---|---|
video Video | 必需:1 个视频 |
short Short | 必需:1 个视频 |
用 curl 排期一条 YouTube 帖子
三个请求:找到你的频道,帖子有文件的话先上传,然后创建帖子。把密钥换成你在设置,再到 API 密钥里生成的那个,把 12 换成你自己的频道 id。
1. 列出你的频道,记下 YouTube 账号的 id。
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. 上传文件。响应会给出媒体 id,下面作为 mediaFiles 使用。
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@clip.mp4" 3. 创建帖子。
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "Everything we shipped this week",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"platformSpecific": {
"youtube": {
"title": "Launch day recap",
"privacyStatus": "public"
}
}
}' 响应是创建好的帖子,带有 id 和状态。之后用 GET /api/posts/{id} 获取,查看发布结果。
YouTube 选项
把这些放在 platformSpecific 里,使用 YouTube 对应的键。
| 选项 | 作用 | 接受的值 |
|---|---|---|
title | 标题 | 文本 |
privacyStatus | 公开、不公开列出或私享 | publicunlistedprivate |
categoryId | 分类 | 文本 |
madeForKids | 儿童内容设置 | true 或 false |
playlistId | 添加到播放列表 | 文本 |
thumbnailUrl | 封面图,使用公开网址 | 文本 |
要查找某个频道可用的 播放列表,请调用 GET /api/channels/{id}/options。
通过 API 获取 YouTube 数据分析
每条 YouTube 帖子的这些数据会通过 GET /api/posts/{id}/metrics 返回,并带有随时间变化的快照。
- 展示量
- 点赞
- 评论
- 视频播放量
- 互动率
评论和消息
通过 API,你可以读取并回复已发布帖子下的评论。
读取评论所有套餐都支持。回复评论需要付费套餐,收件箱属于 Pro 和 Business。在你的账号开通某项功能之前,API 会返回 403 和一个可供检查的代码。
所有套餐都能使用 API
每个套餐都包含 API 密钥,Free 套餐也不例外。各套餐的额度如下。
| 套餐 | API 密钥 | 每日请求数 |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5,000 |
| Business | 10 | 50,000 |
直接对接 YouTube,还是使用 BulkPublish
BulkPublish 替你维护连接:刷新令牌,在排队之前按 YouTube 的规则检查每条帖子,并在帖子上报告失败的目标,所以你的代码只需发一个请求。
想直接问助手?
Claude、ChatGPT 和 Cursor 可以通过 YouTube MCP 服务器完成同样的事,用提示词代替代码。
更喜欢日历而不是代码?
同一个 YouTube 账号也可以在应用里排期,配有内容日历和批量上传。
常见问题
关于 YouTube API 的常见问题。
有没有不用自己开发集成就能用的 YouTube API?
有。BulkPublish 通过它的 REST API 开放 YouTube。只需连接一次 YouTube 账号,之后就可以用密钥发布、排期和管理。同一个密钥也适用于你连接的其他所有网络。
通过 API 可以向 YouTube 发布什么?
帖子类型有 Video和Short。排队之前,每条内容都会按 YouTube 的素材规则检查,所以 YouTube 会拒绝的请求会立刻失败,并给出清楚的错误。
可以通过 API 排期 YouTube 帖子吗?
可以。发送状态 "scheduled",并带上 scheduledAt 时间和 timezone,或者先请求队列中的下一个空闲时段。重复排期和 RSS 源同样可用。
可以通过 API 读取 YouTube 数据分析吗?
可以。每条帖子的数据包括 展示量、点赞、评论、视频播放量和互动率,并带有随时间变化的快照。
可以通过 API 读取并回复 YouTube 的评论或消息吗?
可以。你可以读取并回复已发布帖子下的评论。回复评论需要付费套餐,收件箱属于 Pro 和 Business。
YouTube API 要额外付费吗?
不用。所有套餐都能使用 API。Free 包含 1 个密钥和每天 30 次请求,Pro 为 5 个密钥和每天 5,000 次,Business 为 10 个密钥和每天 50,000 次。
需要 YouTube 开发者账号或应用审核吗?
使用 BulkPublish 不需要。你在频道页面连接 YouTube 账号,用 BulkPublish 密钥发布即可。如果你改为直接对接 YouTube 自己的 API,上面的部分列出了它对你的要求。
AI 助手也能做这些吗?
能。YouTube MCP 服务器页面介绍了如何连接 Claude、ChatGPT 或 Cursor,以及该怎么提问。
其他网络
同一个密钥和同样的请求格式适用于 15 个网络。