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。
- 向 /v1/youtube/search-shorts 发送 {"query": "meal prep", "results_limit": 25}。
- 轮询 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/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。
相关 API
除了 YouTube Shorts Search API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Comments API — 采集公开评论、作者、互动、来源视频和对话关系。
- YouTube Videos API — 获取已知视频或 Short URL 的元数据、缩略图、时长和互动指标。
- YouTube Search API — 按关键词搜索公开普通视频,并支持元数据筛选。
- YouTube Hashtag Search API — 从话题标签信息流发现公开视频,可采集全部内容或仅采集 Shorts。
- YouTube Related Videos API — 按视频 URL 列出播放页旁推荐的视频,返回标题、频道、播放量和缩略图。
- YouTube Channel Search API — 按关键词查找频道,返回频道名称、订阅数、头像和简介片段。
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API