youtube/
trending-shorts

无需任何输入,抽取 YouTube 当前正在流行的 Shorts,返回标题、频道、播放量、点赞数、评论数、时长和精确的发布时间。

YouTube Trending Shorts API

无需输入
每次重新抽样
播放、点赞、评论
每条结果 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

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。

  1. 向 /v1/youtube/trending-shorts 发送 {"results_limit": 48},请求体也可以留空。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 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。

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

探索其他平台

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

YouTube Trending Shorts API — 常见问题

YouTube Trending Shorts API 是一个用于抽取 YouTube 当前热门 Shorts 的 API,不需要提供任何搜索输入。它返回每条 Shorts 的标题、频道、播放量、点赞数、评论数、时长和发布时间。

每次运行都会从热门池里重新抽一批,相隔几分钟的两次结果只会有少量重合。定时多跑几次再按 id 合并,能更完整地看到当下的热门内容。

results_limit 可以设为 1 到 200,默认 48,大约是从热门池抽取一次的数量。

播放量和点赞数是:views_count、likes_count 都是取自每条 Shorts 的完整整数。comments_count 来自 YouTube 页面上显示的数字,超过一千时是取整后的值,例如 4.8K 记为 4800;创作者隐藏点赞数或评论数时,对应字段为 null。

没有国家参数。每次运行返回的是当时热门池里的 Shorts,可以定时运行并按 id 合并,追踪热门池的变化。

每返回一条 Shorts 计 0.5 积分,默认的 48 条共计 24 积分。