ai-search/
llm-mentions

找出引用某个域名、或提到某个关键词的 AI 概览和 ChatGPT 回答,返回每个问题、Markdown 格式的完整回答、回答引用的来源,以及问题的月度 AI 搜索量。

LLM Mentions API

AI 概览与 ChatGPT
完整回答文本
引用来源
AI 搜索量
每次请求 40 积分 + 每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

LLM Mentions

LLM 提及指的是 Google AI 概览或 ChatGPT 在回答某个问题时引用了一个域名、或在回答里出现了某个关键词,每条记录都带着完整回答、回答引用的页面、生成它的模型、这个问题每月被问多少次;ChatGPT 的回答还会附上提到的品牌和它额外做的延伸搜索。把这些回答放在一起看,就能知道哪些问题让品牌出现在 AI 用户面前、模型主要依赖哪些来源、哪些回答对产品的描述有偏差,可用于生成式引擎优化(GEO)审计、内容规划和竞品对比。

LLM Mentions API 主要特性

  • 从域名或关键词出发target 查找引用某个域名(如 notion.so)的回答,query 查找提到某个关键词或品牌名的回答,既能盯自己的网站,也能看用户如何描述你所在的品类。
  • 用户看到的原样回答answer 以 Markdown 保留完整回答,包括标题、列表和行内链接,可以直接引用或核对模型给出的原话。
  • 回答引用的每个页面sources 列出每个被引用页面的位置、标题、网址、域名、站点名称和摘录,能看出是谁的内容影响了这段回答。
  • 每个问题背后的需求量ai_search_volume 估算这个问题每月被问的次数,方便区分高需求问题里的提及和冷门问题里的提及。
  • ChatGPT 的品牌、网页结果和延伸搜索platform 设为 chat_gpt 时,brands 按出现顺序列出回答中的品牌,search_results 给出 ChatGPT 参考过的网页,fan_out_queries 记录它额外执行的搜索。
  • 回答被记录的时间first_seen_at 和 last_seen_at 给出每条回答的记录时间,便于区分长期存在的回答和新出现的回答。

LLM Mentions API 参数

参数必填描述
target必填(至少一项)要在 AI 回答中追踪的域名,例如 hubspot.com,不带页面路径。与 query 二选一。
query必填(至少一项)要在 AI 回答中追踪的关键词或品牌名,例如 crm software,最多 250 个字符。与 target 二选一。
platform可选google 读取 Google AI 概览,为默认值;chat_gpt 读取美国英语环境下的 ChatGPT 回答。
location_code可选市场位置代码,默认 2840(美国),也是 chat_gpt 回答覆盖的市场。
location_name可选市场位置名称,可代替 location_code;填写后优先于 location_code。
language_code可选回答语言代码,默认 en,也是 chat_gpt 回答使用的语言。
language可选回答语言名称,可代替 language_code;填写后优先于 language_code。
results_limit可选最多返回的回答数,可填 1–1000,默认 100。

如何使用 LLM Mentions API

提交一个域名或关键词,每条 AI 回答返回一行。

  1. 向 /v1/ai-search/llm-mentions 发送 {"target": "notion.so", "platform": "google", "results_limit": 100}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取回答;has_more 为 true 时用 results.next_cursor 请求下一页。
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}'

LLM Mentions API 最佳使用场景

  • 审计域名在 AI 回答中的露出: 把自己的域名作为 target,按 ai_search_volume 排序,再读 answer 和 sources,看哪些高需求问题引用了你、又是怎么描述你的。
  • 找出 AI 在某个品类里信任的页面: 用品类关键词作为 query,统计 sources 中的域名和网址,整理出值得投稿合作或对标改进的文章清单。
  • 对比 ChatGPT 回答里的品牌: platform 设为 chat_gpt,分别查自己和竞品,对比同一批问题中 brands 出现的品牌及其先后位置。
  • 从缺席的问题规划内容: 收集品牌没有出现的回答里的 question 和 fan_out_queries,变成内容选题,写出模型可以引用的页面。

LLM Mentions API 使用建议

  • 同一个品牌建议两种方式都查:域名放 target,品牌名放 query,因为“引用网站”和“提到名字”得到的回答集合不同。
  • 需要的回答尽量在一次请求里用较大的 results_limit 取完,因为每次请求都会收取 40 积分的基础费。
  • 每次运行后保存各行的 id,下次对比 last_seen_at,就能区分新回答和已经看过的回答。

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

  • AI Search Visibility API — 统计 AI 回答提及某个域名或关键词的次数和 AI 搜索量,列出最常被引用的域名,在 ChatGPT 上还给出同时出现的品牌。
  • LLM Top Sources API — 按关键词或域名排出 AI 概览和 ChatGPT 回答中引用最多的 10 个域名或页面,附引用次数和 AI 搜索量。
  • Google AI Mode API — 获取 Google AI 模式针对一次搜索写出的完整 Markdown 回答及全部引用来源,可选任意国家和语言。

探索其他平台

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

LLM Mentions API — 常见问题

LLM Mentions API 根据一个域名或关键词,返回引用该域名或提到该关键词的 Google AI 概览和 ChatGPT 回答。每行包含问题、完整回答、引用来源、模型以及该问题的月度 AI 搜索量。

platform 为 google 时读取所选市场的 Google AI 概览;为 chat_gpt 时读取美国英语环境下的 ChatGPT 回答。

想找引用某个网站的回答就用 target 填域名;想找提到某个词或品牌名的回答就用 query。每次请求只能二选一。

品牌名、参考过的网页结果和延伸搜索只在 ChatGPT 的回答里记录,需要把 platform 设为 chat_gpt。

每次请求计 40 积分,每返回一条回答再加 0.5 积分;没有匹配到回答时同样收取 40 积分。