youtube/
related-videos

按视频链接列出 YouTube 在该视频旁推荐的视频,一次运行返回每条推荐的标题、频道、播放量和缩略图。

YouTube Related Videos API

视频链接输入
接下来观看推荐
频道和播放量
每条结果 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

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

提交一个视频链接,读回推荐列表。

  1. 向 /v1/youtube/related-videos 发送 {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 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。

除了 YouTube Related Videos API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。

探索其他平台

还可以将 YouTube 数据与其他已支持社交平台的公开数据结合使用。

YouTube Related Videos API — 常见问题

YouTube Related Videos API 是一个用于按视频链接获取 YouTube 在该视频旁推荐的视频列表的 API。它返回每条推荐的标题、频道、播放量和缩略图。

返回 YouTube 为该视频展示的完整列表,通常约 20 个。

可以。Shorts 链接、youtu.be 短链、直播链接和普通 watch 链接都支持。

不能了。官方 Data API 从 2023 年 8 月 7 日起不再支持搜索接口的 relatedToVideoId 参数,要拿到 YouTube 在视频旁边展示的推荐列表,可以用这个接口。

每返回一个推荐视频计 0.5 积分,常见的 20 个共计 10 积分。