youtube/
trending-videos

选一个分类(新闻、游戏、体育等)和一个国家,按名次拿到该分类趋势页上的视频,附带频道、播放次数、时长和缩略图。

YouTube Trending Videos API

7 个分类
任意国家
按名次排列
每条结果 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

YouTube Trending Videos

YouTube 的趋势页按国家、按分类(新闻、游戏、体育等)列出当下最受关注的视频,并显示每条视频的名次、频道、播放次数、时长和发布到现在多久。持续跟踪这些榜单,就能看出某个市场里哪些新闻、游戏和创作者正在走红,以及一条视频冲上榜单、掉出榜单的速度。

YouTube Trending Videos API 主要特性

  • 7 个分类趋势页category 可选新闻、游戏、体育、学习、课程、时尚和购物,每个任务对应该分类观众看到的那份榜单。
  • 用两位字母代码指定国家region 接受 US、GB、JP、BR 这样的国家代码,返回该国家的趋势页;同一个分类在不同国家上榜的视频往往不一样。
  • 每条视频都带名次rank 从 1 开始记录名次,并与 category、region 一起返回,把几份榜单合并到一张表里也不会混淆。
  • 上榜视频的频道信息author 包含频道 ID、名称、@handle、链接、头像和认证标识,不用再查一次就能按频道汇总上榜视频。
  • 播放次数、时长和缩略图metrics.views_count、duration_seconds、thumbnail_url 以及 text 里的简介片段,与视频在趋势页上的展示一致。

YouTube Trending Videos API 参数

参数必填描述
category必填要读取的趋势分类:news、gaming、sports、learning、courses、fashion 或 shopping。
region可选趋势页所属国家的两位字母代码,例如 US、GB 或 JP,默认 US。
results_limit可选从榜单顶部开始返回的视频数量,1 到 50,默认 50。

如何使用 YouTube Trending Videos API

选好分类和国家,提交给 YouTube Trending Videos API,任务完成后按名次读取榜单。

  1. 向 /v1/youtube/trending-videos 发送 {"category": "news", "region": "US", "results_limit": 50},记下 task_id。
  2. 每隔几秒请求一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 视频按名次排在 results.items 里;results.has_more 为 true 时,带上 results.next_cursor 读取下一页。
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"gaming","region":"GB","results_limit":10}'

# 返回结果里有 task_id。
# status 变成 succeeded 后,GET /v1/tasks/{task_id} 会按名次返回视频。

YouTube Trending Videos API 最佳使用场景

  • 每日市场热点简报: 每天早上拉取某个国家的新闻和体育趋势页,把正在走红的标题、频道和播放次数按名次交给编辑。
  • 跟踪游戏圈的热门内容: 在你发布内容的几个国家持续跟踪游戏趋势页,提前发现正在升温的游戏、内容形式和创作者,再安排选题或投放。
  • 对比同一分类在不同国家的榜单: 对同一个分类换几个 region 分别查询,按视频 ID 对齐,看哪些视频在多个国家都上榜,哪些只在本地走红。
  • 整理可以合作的频道名单: 收集反复登上某个分类趋势页的频道,连同 @handle 和认证标识,作为达人合作的初始名单。

YouTube Trending Videos API 使用建议

  • 在固定时间查询同一个分类和国家,按 id 对齐多次结果,名次的变化就能说明哪些视频在上升、哪些在回落。
  • published_time_text 要和 collected_at 一起看:趋势页只显示“15 min ago”这类相对时间,需要大致的上传时间时,用采集时间往前推即可。
  • 只关心榜单前几名时,把 results_limit 设为 10 或 20;YouTube Trending Videos API 按返回的视频条数计费。
  • 拿到的视频 ID 可以交给 YouTube Videos API 查点赞、评论和完整简介,或交给 YouTube Transcripts API 读取视频里说了什么。

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

探索其他平台

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

YouTube Trending Videos API — 常见问题

YouTube Trending Videos API 是一个用于按国家获取 YouTube 某个分类(如新闻、游戏、体育)趋势视频的 API。它返回每条视频的名次、标题、频道、播放次数、时长、缩略图和发布到现在多久。

2025 年 7 月,YouTube 用各分类的趋势榜取代了原来统一的 Trending 页面,游戏类趋势保留在游戏探索页。YouTube Trending Videos API 读取的就是这些分类趋势页,所以需要选择要跟踪的分类。

把 region 设为该国家的两位字母代码,例如日本是 JP、德国是 DE。每个国家都有自己的榜单,同一个分类在不同市场上榜的视频可能完全不同。

新闻、游戏、体育、学习、课程、时尚和购物。每个任务查一个分类,需要多个分类时分别提交任务。

用 results_limit 设置,最多从榜单顶部取 50 条。榜单较短的分类会返回它现有的视频,只按实际返回的条数计费。

YouTube Trending Videos API 每返回一条视频扣 0.5 积分,取满 50 条是 25 积分,只取前 10 条是 5 积分。