youtube/
search-shorts

按关键词搜索 YouTube Shorts,按搜索排序返回每条 Shorts 的链接、文案、播放量、竖版缩略图和文案中的话题标签。

YouTube Shorts Search API

关键词输入
只含 Shorts
最多 200 条
每条结果 0.6 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

YouTube Shorts Search

Shorts 搜索结果是 YouTube 在 Shorts 筛选下为某个关键词排出的竖屏短视频,每条都显示文案、播放量和 9:16 的缩略图。横向看这些结果,就能发现在一个话题下哪些开头和切入角度最能抓住注意力,也能顺手攒下一批值得研究或持续追踪的 Shorts 链接。

YouTube Shorts Search API 主要特性

  • 只返回 Shorts结果来自 YouTube 的 Shorts 搜索,长视频、频道和播放列表都不会混进来。
  • 文案、播放量和缩略图text 是 Shorts 的文案,metrics.views_count 由展示的播放量换算而来,media 是带尺寸的竖版缩略图。
  • 文案里的话题标签文案中写到的标签会整理进 hashtags,方便在整批结果里做统计。
  • 可直接使用的 Shorts 链接每条结果都有 youtube.com/shorts/ 链接和视频 ID,方便继续查询。

YouTube Shorts Search API 参数

参数必填描述
query必填用来搜索 Shorts 的关键词,最多 100 个字符。
results_limit可选返回的 Shorts 数量,取值 1 到 200,默认 25。

如何使用 YouTube Shorts Search API

用关键词搜索,读取匹配的 Shorts。

  1. 向 /v1/youtube/search-shorts 发送 {"query": "meal prep", "results_limit": 25}。
  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/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"meal prep","results_limit":25}'

# 每条结果是一个 Shorts,包含 text、metrics.views_count 和 shorts 链接。

YouTube Shorts Search API 最佳使用场景

  • 研究一个话题的开头套路: 读一读某个关键词下播放量最高的几条 Shorts 文案,看看哪些开场白和卖点最能带来播放。
  • 追踪关键词下的 Shorts 变化: 定期重复同一个搜索,对比哪些视频 ID 新进入或掉出了结果。
  • 为深入分析收集 Shorts: 把一个主题下的 Shorts 链接收集起来,交给 YouTube Videos 补齐频道、点赞和发布日期。

YouTube Shorts Search API 使用建议

  • 搜索结果只带文案和播放量,需要频道或点赞数时,把留下的链接交给 YouTube Videos。
  • 播放量来自 635K 这类四舍五入的展示文本,比较时看量级,不要当精确值。
  • 后面几页会和前面重复一部分 Shorts,结果会先按视频 ID 去重,再计入 results_limit。

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

探索其他平台

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

YouTube Shorts Search API — 常见问题

YouTube Shorts Search API 是一个用于按关键词搜索 YouTube Shorts 的 API。它按 YouTube 的搜索排序返回每条 Shorts 的链接、文案、播放量和竖版缩略图。

把这条 Shorts 的链接交给 YouTube Videos,它会返回频道、点赞数、评论数和发布日期。

results_limit 可设为 1 到 200,默认 25,大约是一页 Shorts 搜索结果。

官方搜索没有只搜 Shorts 的筛选项,videoDuration=short 会匹配所有 4 分钟以内的视频。这个接口的结果来自 YouTube 的 Shorts 搜索,返回的每一条都是 Shorts。

每返回一条 Shorts 计 0.6 积分,默认的 25 条共计 15 积分。