ai-search/
google-ai-mode

提交一个搜索词,拿到 Google AI 模式为它写出的完整回答(Markdown 格式),以及去重后的引用来源列表,每条包含标题、URL、域名和摘录。

Google AI Mode API

Markdown 完整回答
引用来源
任意国家和语言
每次搜索一行
每次请求 2 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Google AI Mode

Google AI 模式是 Google 搜索里的对话式标签页,它针对搜索词直接写出完整回答而不是列出链接,并在正文旁标注所依据的页面。针对业务关键的搜索阅读这些回答,可以看出 Google 在向用户怎样介绍一个品类、自己的网站是否在引用来源之中、哪些竞品被推荐,以及换一个国家或语言后回答会有什么不同。

Google AI Mode API 主要特性

  • 保留格式的完整回答answer 以 Markdown 保存 AI 模式的回答,包括标题、列表和表格,可直接存档、比对或展示。
  • 每个引用来源只出现一次references 列出回答引用的来源并去重,每条包含 position、title、url、domain、网站名称以及回答旁显示的摘录。
  • 自选市场用 location_code 或 location_name、language_code 或 language 设定搜索的国家和语言,同一个搜索词可以在多个市场分别查看。
  • 可回到实时页面url 指向同一搜索词的 AI 模式页面,方便人工核对回答。

Google AI Mode API 参数

参数必填描述
query必填要向 AI 模式提问的搜索词,例如 best crm for startups。
location_code可选搜索市场的地区代码,默认 2840(美国)。
location_name可选市场名称,可代替 location_code;填写后优先于 location_code。
language_code可选搜索语言代码,默认 en。
language可选语言名称,可代替 language_code;填写后优先于 language_code。

如何使用 Google AI Mode API

提交搜索词,读取回答及其来源。

  1. 向 /v1/ai-search/google-ai-mode POST {"query": "best crm for startups", "location_code": 2840, "language_code": "en"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 读取 results.items 中的唯一一行:answer 是回答正文,references 是引用的页面。
curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best crm for startups","location_code":2840,"language_code":"en"}'

Google AI Mode API 最佳使用场景

  • 检查自己的页面是否被引用: 批量查询重点搜索词,在 references 里查找自己的域名,记录它的位置和 Google 显示的摘录。
  • 看 AI 模式推荐了哪些品牌: 阅读“品类最佳工具”这类购买意图搜索的 answer,记录点名了哪些产品以及先后顺序。
  • 对比不同市场的回答: 用不同的地区和语言设置查询同一个搜索词,在 AI 模式对各市场说法不同的地方做本地化内容。

Google AI Mode API 使用建议

  • 需要长期追踪时,保存 Markdown 格式的 answer 并对比各版本,措辞变化会直接体现为文本差异。
  • 回答引用了竞品页面时,打开对应的 references 条目阅读摘录,看看 Google 依据的是哪一段内容。
  • 想看很多问题下的 AI 回答而不只是一次搜索时,改用 LLM Mentions API,并把自己的域名作为 target。

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

  • LLM Mentions API — 按域名或关键词查找引用或提及它的 AI 概览与 ChatGPT 回答,附回答全文、引用来源和问题的 AI 搜索量。
  • AI Search Visibility API — 统计 AI 回答提及某个域名或关键词的次数和 AI 搜索量,列出最常被引用的域名,在 ChatGPT 上还给出同时出现的品牌。
  • LLM Top Sources API — 按关键词或域名排出 AI 概览和 ChatGPT 回答中引用最多的 10 个域名或页面,附引用次数和 AI 搜索量。

探索其他平台

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

Google AI Mode API — 常见问题

Google AI Mode API 返回 AI 模式针对一个搜索词写出的完整回答(Markdown 格式),以及去重后的引用来源和它们的标题、URL、域名与摘录。

AI 模式是 Google 搜索中独立的对话式标签页,会为每个搜索词写出完整回答,本 API 读取的就是这个标签页;AI 概览的回答由 LLM Mentions API 覆盖。

可以。默认是美国(2840)和英语(en),通过 location_code 或 location_name、language_code 或 language 修改。

每次请求 2 积分,返回一行,包含回答和它的来源。