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 回答返回一行。
- 向 /v1/ai-search/llm-mentions 发送 {"target": "notion.so", "platform": "google", "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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,就能区分新回答和已经看过的回答。
相关 API
除了 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 回答及全部引用来源,可选任意国家和语言。