YouTube Related Videos
相关视频是 YouTube 在播放页旁边排出的“接下来观看”推荐,每条都显示标题、频道、播放量和缩略图。这份列表能看出 YouTube 把哪些视频和频道归为同一类,适合用来摸清一个细分领域、找出竞争频道,以及规划能出现在目标视频旁边的内容。
YouTube Related Videos API 主要特性
- 常见视频链接都能用watch 链接、youtu.be 短链、Shorts 链接和直播链接都能识别出视频 ID。
- 一次拿到整份列表一次任务返回 YouTube 为该视频展示的完整推荐列表,通常约 20 个视频。
- 每条推荐的来源频道author 包含每个推荐视频所属频道的 ID、名称和频道链接。
- 播放量和缩略图metrics.views_count 由 YouTube 显示的 2.2M 这类播放量换算而来,media 提供尺寸最大的缩略图。
YouTube Related Videos API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | YouTube 视频链接,可以是 watch 链接、youtu.be 短链、Shorts 链接或直播链接。 |
如何使用 YouTube Related Videos API
提交一个视频链接,读回推荐列表。
- 向 /v1/youtube/related-videos 发送 {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 results.items 读取推荐视频;has_more 为 true 时用 results.next_cursor 继续翻页。
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
# 每条结果是一个推荐视频,包含 author 和 metrics.views_count。YouTube Related Videos API 最佳使用场景
- 围绕一个视频摸清赛道: 从一个表现好的视频出发取推荐列表,再对结果继续取推荐,就能画出 YouTube 归在一起的那一片内容。
- 找出竞争频道: 统计各个 author.id 在你自己视频旁出现的次数,看 YouTube 总把哪些频道推荐在你旁边。
- 确认自己的视频被推荐到了哪里: 对竞品的热门视频运行本接口,在推荐列表里查找自己视频的 ID。
YouTube Related Videos API 使用建议
- views_count 来自 2.2M 这类四舍五入的展示文本,把它当作近似值使用。
- 推荐列表会随时间变化,对比多次结果时把每份列表的 collected_at 一起存下来。
- 需要精确的播放数、发布日期和时长时,把留下的视频链接交给 YouTube Videos。
相关 API
除了 YouTube Related Videos API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Channel Videos API — 通过频道 URL 采集公开普通视频,不包含 Shorts 和直播。
- YouTube Comments API — 采集公开评论、作者、互动、来源视频和对话关系。
- YouTube Transcripts API — 获取可用纯文本字幕,并支持可选语言。
- YouTube Channels API — 获取公开频道身份、图片、认证状态和可见受众统计。
- YouTube Videos API — 获取已知视频或 Short URL 的元数据、缩略图、时长和互动指标。
- YouTube Shorts API — 按频道采集公开 Shorts、缩略图、时长、发布时间和互动指标。
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API