ai-search/
llm-brand-metrics

统计 Google AI 概览或 ChatGPT 有多少回答提到某个域名或关键词,给出这些回答的 AI 搜索量合计、最常引用的域名,以及同时出现的品牌。

AI Search Visibility API

AI 声量份额
被引用的域名
同框出现的品牌
AI 概览与 ChatGPT
每次请求 40 积分 + 每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

AI Search Visibility

AI 搜索可见度指的是品牌在 AI 生成回答里的露出程度:Google AI 概览或 ChatGPT 有多少回答提到或引用了它,这些问题背后每月有多少搜索需求,回答依据的是哪些网站,同一段回答里还点名了哪些品牌。把自己和竞品放在一起衡量,就能看出 AI 在某个品类里更常推荐谁、哪些媒体左右着这种推荐,以及内容或公关投入之后可见度有没有上升。

AI Search Visibility API 主要特性

  • 一行看清整体露出total 行给出 mentions_count,即提到或引用该域名、关键词的 AI 回答数量,以及 ai_search_volume,即这些回答对应问题的月度需求合计。
  • 回答引用了哪些域名source_domain 行列出这些回答引用最多的 10 个网站,看清是哪些媒体在影响 AI 对你的描述。
  • AI 参考过的网页结果search_result_domain 行按出现次数列出 AI 作答前查看过的网页结果所属域名,相当于这些回答背后的阅读清单。
  • 与你同框的品牌和品类platform 为 chat_gpt 时,brand 和 brand_category 行列出同一批回答中出现的品牌与产品品类,直接看出你在和谁被放在一起比较。
  • 域名或关键词都能作为对象用 target 衡量一个网站,用 query 衡量产品名、品类或话题,AI 概览和 ChatGPT 均可选择。

AI Search Visibility API 参数

参数必填描述
target必填(至少一项)要衡量的域名,例如 hubspot.com,不带页面路径。target 与 query 二选一。
query必填(至少一项)要衡量的关键词、品牌名或话题,例如 crm software。target 与 query 二选一。
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。

如何使用 AI Search Visibility API

提交域名或关键词,读取总计和各个拆分维度。

  1. 向 /v1/ai-search/llm-brand-metrics POST {"target": "hubspot.com", "platform": "chat_gpt"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 读取 results.items,按 dimension 分组:先看 total,再依次看 source_domain、search_result_domain、brand 和 brand_category 的排名。
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"}'

AI Search Visibility API 最佳使用场景

  • 和竞品对比 AI 声量份额: 在同一 platform 下分别查询自己和两个竞品的域名,对比 total 行的 mentions_count 和 ai_search_volume,看 AI 更常提到谁。
  • 找到支撑你 AI 露出的媒体: 根据 source_domain 行挑出值得投稿或合作的测评站、媒体和社区,AI 提到你时依据的正是这些页面。
  • 追踪发布或活动后的可见度变化: 定期保存 total 行,对比产品发布、公关投放或内容更新前后的数值。

AI Search Visibility API 使用建议

  • 需要 brand 和 brand_category 行时,把 platform 设为 chat_gpt;AI 概览请求只返回总计和域名维度。
  • 对比多个品牌时,保持 platform、市场和语言完全一致,总计数据才是在同一批回答里比较。
  • 需要具体页面而不是域名时,对同一个 target 或 query 调用 LLM Top Sources API,并把 content_type 设为 pages。
  • 域名的 total 提及很少时,再用品牌名作为 query 查一次,因为回答可能点名品牌却不链接它的网站。

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

  • LLM Mentions API — 按域名或关键词查找引用或提及它的 AI 概览与 ChatGPT 回答,附回答全文、引用来源和问题的 AI 搜索量。
  • LLM Top Sources API — 按关键词或域名排出 AI 概览和 ChatGPT 回答中引用最多的 10 个域名或页面,附引用次数和 AI 搜索量。
  • Google AI Mode API — 获取 Google AI 模式针对一次搜索写出的完整 Markdown 回答及全部引用来源,可选任意国家和语言。

探索其他平台

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

AI Search Visibility API — 常见问题

AI Search Visibility API 用来衡量 Google AI 概览或 ChatGPT 的回答提到某个域名或关键词的频率,返回这些回答的 AI 搜索量合计、引用和参考过的域名,在 ChatGPT 上还包括同时出现的品牌和品类。

一行总计,之后每个拆分维度最多 10 行:被引用的域名、搜索结果域名,以及 chat_gpt 上的品牌和品牌类别。

mentions_count 是提到或引用该域名、品牌或品类的 AI 回答数量,ai_search_volume 是这些回答对应问题的月度 AI 搜索量合计。

每次请求 40 积分,每返回一行再加 0.5 积分;没有任何回答提到该域名或关键词时,同样收取 40 积分。