YouTube Trending Shorts
热门 Shorts 是 YouTube 此刻正在大范围推送的竖屏短视频,每一条都带着标题、发布频道、播放量、点赞数、评论数、时长和准确的上传时间。把这些信号放在一起看,就能知道哪些题材、形式和创作者正在冒头,以及一条 Shorts 发布后涨播放的速度有多快。
YouTube Trending Shorts API 主要特性
- 直接取自热门池不需要填任何参数,每次运行都会抽取 YouTube 当时正在推的 Shorts,每抽一次约 48 条,多抽几次的结果会去重合并,直到达到 results_limit。
- 每条带三项互动数据metrics 里有精确的播放量和点赞数,以及 YouTube 页面显示的评论数,讨论热烈的视频和只是被大量观看的视频一眼就能分开。
- 附带发布频道author 包含频道 ID、账号名、频道名称、链接和头像,可以直接交给频道类接口继续查。
- 发布时间和时长published_at 是精确到秒的 UTC 上传时间,duration_seconds 是视频长度,能看出一条热门 Shorts 有多新、有多长。
- 从文案里提取的话题标签标题或描述里出现的标签会整理到 hashtags 中,不带开头的 #。
YouTube Trending Shorts API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
results_limit | 可选 | 返回的热门 Shorts 数量,取值 1 到 200,默认 48。 |
如何使用 YouTube Trending Shorts API
按需填写返回数量,任务完成后读取热门 Shorts。
- 向 /v1/youtube/trending-shorts 发送 {"results_limit": 48},请求体也可以留空。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 results.items 读取 Shorts;has_more 为 true 时,用 results.next_cursor 继续翻页。
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit":48}'
# 每条结果是一个 Shorts,播放量在 metrics.views_count,频道在 author。
# 通过 GET /v1/tasks/{task_id} 读取。YouTube Trending Shorts API 最佳使用场景
- 每日热门快照: 在固定时间点运行并保存每一批结果,观察哪些题材和形式反复出现在热门 Shorts 里。
- 发现正在起量的创作者: 对照 views_count 和 published_at,找出新视频几天内就拿到上百万播放的频道。
- 追踪短视频话题标签: 统计热门 Shorts 里出现的 hashtags,看看这周跟着爆款一起走的是哪些标签。
YouTube Trending Shorts API 使用建议
- 每次运行都是重新抽样,保存时记下每条 Shorts 的 id,合并相隔几分钟的多次结果时按 id 跳过重复项。
- 用 views_count 除以距 published_at 的小时数,可以按涨播放的速度排序,而不只看总播放量。
- 还需要订阅数或频道简介时,把 author.url 交给 YouTube Channels。
相关 API
除了 YouTube Trending Shorts 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 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
- YouTube Trending Videos API