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,任务完成后按名次读取榜单。
- 向 /v1/youtube/trending-videos 发送 {"category": "news", "region": "US", "results_limit": 50},记下 task_id。
- 每隔几秒请求一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 视频按名次排在 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 读取视频里说了什么。
相关 API
除了 YouTube Trending 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 Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API