YouTube Search Suggestions
搜索联想词是观众还在输入时 YouTube 搜索框就给出的补全建议,并按观众所在的语言和地区排序。它们直接反映了一个种子词周围真实的搜索说法,是做关键词调研、拟视频标题、选标签和找选题的一手素材。
YouTube Search Suggestions API 主要特性
- 与观众看到的顺序一致rank 记录每个联想词在下拉框里的位置,排第一的补全从 1 开始。
- 可以切换市场用 language 和 region 切换到其他市场,例如 es 加 MX 就是墨西哥的西班牙语搜索。
- 每个联想词附搜索链接每条联想词都带有对应的 YouTube 搜索结果链接,并注明请求时用的种子词和市场。
YouTube Search Suggestions API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 需要补全的搜索词开头,最多 100 个字符。 |
language | 可选 | 联想词使用的语言代码,例如 en、es 或 pt-BR,默认 en。 |
region | 可选 | 搜索市场的两位国家或地区代码,例如 US 或 GB,默认 US。 |
如何使用 YouTube Search Suggestions API
提交搜索词的开头,读回排好序的联想词。
- 向 /v1/youtube/search-suggestions 发送 {"query": "iphone 17"},需要其他市场时加上 language 和 region。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 按 rank 顺序从 results.items 读取联想词;has_more 为 true 时用 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"iphone 17"}'
# 每条结果是一个联想词:keyword、rank、language 和 region。YouTube Search Suggestions API 最佳使用场景
- 扩展种子关键词: 取出产品名或话题名的补全,找到观众实际在搜的长尾说法。
- 让标题贴合搜索习惯: 从排名靠前的联想词里挑措辞,让视频标题和人们输入的搜索词保持一致。
- 对比不同市场的需求: 同一个种子词换不同的 language 和 region 运行,看搜索意图在各个国家之间如何变化。
YouTube Search Suggestions API 使用建议
- 在种子词后面加一个字母,比如 iphone 17 a,可以拿到接着这个字母往下补全的联想词。
- 长期追踪同一个种子词时保持 language 和 region 不变,因为每个市场的联想列表各不相同。
相关 API
除了 YouTube Search Suggestions API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Channel Videos API — 通过频道 URL 采集公开普通视频,不包含 Shorts 和直播。
- YouTube Comments API — 采集公开评论、作者、互动、来源视频和对话关系。
- YouTube Search API — 按关键词搜索公开普通视频,并支持元数据筛选。
- YouTube Hashtag Search API — 从话题标签信息流发现公开视频,可采集全部内容或仅采集 Shorts。
- YouTube Channel Search API — 按关键词查找频道,返回频道名称、订阅数、头像和简介片段。
- YouTube Shorts Search API — 按关键词搜索 Shorts,返回链接、文案、播放量和竖版缩略图。
- YouTube Transcripts API
- YouTube Channels API
- YouTube Videos 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 Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API