AI 搜索GEOLLM 提及Google AI 模式API 指南

AI 搜索 API:追踪 LLM 提及、AI 可见度与 Google AI 模式回答

SocQ 新增 4 个 AI 搜索接口:返回引用某个域名的 AI 概览和 ChatGPT 回答、AI 搜索声量占比、被引用最多的来源,以及完整的 Google AI 模式回答。

SocQ更新于 2026年11月19日阅读约 7 分钟

做生成式引擎优化(GEO)需要知道 AI 回答里到底说了什么:哪些问题引用了你的域名,你的品牌和竞品一起出现的频率,AI 在你的品类里信任哪些网站,以及 Google AI 模式针对某个搜索写了什么。SocQ 于 2026-11-17 在新的 AI Search 平台下上线了 4 个接口。本文介绍每个接口返回什么、怎么请求、价格多少、适合什么场景。

快速回答: 把域名(target)或关键词(query)发送到 POST /v1/ai-search/llm-mentions、/llm-brand-metrics 或 /llm-top-mentioned,读取 AI 概览或 ChatGPT 的回答。把搜索词发送到 POST /v1/ai-search/google-ai-mode,获取一条带来源的 AI 模式回答。轮询 GET /v1/tasks/{task_id} 读取结果。

新上线的 AI 搜索接口

1 SocQ 积分 = $0.005。

接口返回内容价格
LLM Mentions API(LLM 提及)每条引用某域名或提到某关键词的 AI 回答一行:问题、Markdown 格式的完整回答、引用来源和 AI 搜索量每次请求 40 积分($0.20)+ 每条回答 0.5 积分($0.0025)
AI Search Visibility API(AI 搜索可见度)提到某域名或关键词的 AI 回答总数,以及按被引用域名、网页结果域名和(ChatGPT 上的)品牌与品牌类别的拆分每次请求 40 积分($0.20)+ 每行 0.5 积分($0.0025)
LLM Top Sources API(LLM 高频引用来源)某关键词或域名的 AI 回答中被引用最多的前十个域名或页面,按提及次数排名每次请求 40 积分($0.20)+ 每个上榜域名或页面 0.5 积分($0.0025)
Google AI Mode API(Google AI 模式)某个搜索的完整 Google AI 模式回答(Markdown),附全部引用来源每次请求 2 积分($0.01)

三个 LLM 接口在没有找到任何数据时,同样收取 40 积分的基础费用。

鉴权与异步任务流程

所有 SocQ 请求都在 Authorization 请求头中携带 API Key,提交、任务状态和结果请求使用同一个请求头:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次采集都作为后台任务运行:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

提交响应中包含 data.task_id 和 data.status。用这个 ID 轮询任务接口:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

当 status 为 succeeded 时,响应会在 data.results.items 中带上第一页标准化结果。limit 默认 50,最大 500。如果 has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。任务处于 queued、running 或 failed 时,接口只返回任务元数据,不含 results。

在提交请求体中加入可选的 callback_url,任务结束后 SocQ 会发送一次带任务摘要的 POST;结果记录仍通过 GET /v1/tasks/{task_id} 读取。客户端超时不会取消任务,请用同一个任务 ID 继续查询,而不是重新提交并重复付费。402 表示积分不足;429 表示 API Key 触发了频率或积分限制。

LLM Mentions API:引用你的 AI 回答

LLM Mentions API 列出 Google AI 概览或 ChatGPT 引用你的域名、或在回答中提到你的品牌或关键词的问题。通过 target 提供域名,或通过 query 提供关键词,二选一。platform 可选 google(AI 概览,默认)或 chat_gpt(覆盖美国英语回答)。results_limit 默认 100,可填 1 到 1,000。

curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "notion.so",
    "platform": "google",
    "results_limit": 100
  }'

每行是一组问答。最常用的字段:

  • question 和 answer:问题和 Markdown 格式的完整回答。
  • ai_search_volume:该问题每月被提问的估计次数。
  • sources:被引用的页面,含 position、title、url、domain、source 和 text。
  • search_results 和 brands:AI 查看过的网页结果和它提到的品牌(仅 ChatGPT)。
  • fan_out_queries:AI 回答时执行的后续搜索。
  • first_seen_at 和 last_seen_at:该回答首次和最近一次被记录的时间。

可用于审查 GEO 覆盖情况、找出 AI 在你所在领域信任的页面,或发现错误描述你产品的回答。100 条回答计 90 积分($0.45)。全部字段见 LLM 提及文档。

AI Search Visibility API:AI 回答中的声量占比

AI Search Visibility API 是一份 AI 搜索的声量占比报告。第一行是提到你的域名或关键词的 AI 回答总数及其背后的月度 AI 搜索量。之后每个拆分维度最多 10 行:回答中引用最多的域名、AI 查看过的网页结果中的域名,以及在 chat_gpt 上同一回答中出现的品牌和品牌类别。

curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "hubspot.com",
    "platform": "chat_gpt"
  }'

每行包含 dimension(total、source_domain、search_result_domain、brand 或 brand_category)、name、维度内的 rank、mentions_count 和 ai_search_volume。对你的品牌和两个竞品各跑一次,就能比较 AI 更推荐谁。一份包含总计和四个完整拆分维度的 ChatGPT 报告共 41 行,即 60.5 积分($0.3025)。字段说明见 AI 搜索可见度文档。

LLM Top Sources API:AI 在某个话题下引用哪些网站

LLM Top Sources API 回答的是另一个问题:人们询问你的品类时,AI 引用哪些网站?通过 query 提供关键词,或通过 target 提供域名。content_type 可设为 domains(默认)或 pages。results_limit 默认 10,也是上限。

curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "crm software",
    "platform": "google",
    "content_type": "domains"
  }'

结果行与 AI 搜索可见度使用相同的指标结构,dimension 为 domain 或 page。按页面查看时,结果就是一份现成的数字公关外联清单。10 行排名计 45 积分($0.225)。详见 LLM 高频引用来源文档。

Google AI Mode API:一条完整回答及其来源

AI 模式是 Google 搜索中的对话式标签页,它会写出完整回答,而不是列出链接。Google AI Mode API 接收 query,以 Markdown 返回这条回答,并附上去重后的引用来源列表。默认市场为美国(location_code 2840)、语言为英语(language_code en);修改这两个参数即可比较不同国家和语言下的回答。

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"
  }'

每次请求返回一行,包含 query、answer、references(位置、标题、URL、域名、来源和摘录)、location_code、language_code,以及 AI 模式页面的 url。每次搜索 2 积分($0.01),用来检查你的页面是否出现在关注搜索词的来源中,成本很低。见 Google AI 模式文档。

该用哪个接口

  • “哪些 AI 回答提到了我们,说了什么?” 用 LLM Mentions。
  • “和竞品相比,我们在 AI 回答中的可见度如何?” 用 AI Search Visibility,每个域名跑一次。
  • “应该向哪些网站投稿,才能让 AI 引用我们?” 用 LLM Top Sources,设置 content_type: "pages"。
  • “Google AI 模式在这个市场、这个搜索词下怎么回答?” 用 Google AI Mode。

常见顺序是:先用 LLM Top Sources 看品类,再用 AI Search Visibility 对比自己和竞品,最后用 LLM Mentions 阅读数字背后的具体回答。传统排名数据见 SEO 平台。

常见问题

什么是 AI 搜索 API?

一种返回 AI 回答引擎所说内容、而不是链接列表的 API。SocQ 的版本覆盖提到某域名或关键词的 AI 概览和 ChatGPT 回答、可见度指标、被引用最多的来源,以及完整的 Google AI 模式回答。

覆盖哪些 AI 平台?

三个 LLM 接口的 platform 可设为 google(AI 概览,默认)或 chat_gpt。ChatGPT 覆盖美国英语回答。品牌和品牌类别行、AI 查看过的网页结果及品牌列表只在 chat_gpt 上返回。

可以在同一个请求里同时传域名和关键词吗?

不可以。LLM Mentions、AI Search Visibility 和 LLM Top Sources 只接受 target(域名)或 query(关键词)其中之一。两种视角都需要时请分两次请求。

没有找到 AI 回答也收费吗?

是的。三个 LLM 接口在没有数据时同样收取 40 积分基础费用;按结果计的积分只对实际返回的行收取。Google AI Mode 每次请求 2 积分。

一次典型的 GEO 审查要花多少钱?

一次 LLM Top Sources 请求(45 积分)、三份 ChatGPT 可见度报告(每份最多 60.5 积分)和一次 100 条回答的 LLM Mentions 请求(90 积分),合计最多 316.5 积分,约 $1.58。价格可能调整,请先查看接口页面。

AI SEARCH API

使用公开的 AI Search 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 AI Search API