youtube/
search-suggestions

输入搜索词的开头,按所选语言和地区获取 YouTube 搜索框给出的联想词,排序与观众看到的一致。

YouTube Search Suggestions API

搜索联想
语言和地区
按次固定计费
每次请求 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

提交搜索词的开头,读回排好序的联想词。

  1. 向 /v1/youtube/search-suggestions 发送 {"query": "iphone 17"},需要其他市场时加上 language 和 region。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 按 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 不变,因为每个市场的联想列表各不相同。

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

探索其他平台

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

YouTube Search Suggestions API — 常见问题

YouTube Search Suggestions API 是一个用于按所选语言和地区获取 YouTube 搜索框联想词的 API,输入是搜索词的开头部分。它返回每个联想词及其排名。

是的。返回的就是你在 YouTube 搜索框输入时出现的补全建议,顺序也一致。

YouTube 为这个搜索词给出多少就返回多少,通常十几个。

官方 Data API 没有自动补全(autocomplete、typeahead)接口。这个接口返回 YouTube 搜索框里显示的联想词,并按你选择的语言和地区排序。

每次请求固定计 0.5 积分,与返回的联想词数量无关。