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
提交域名或关键词,读取总计和各个拆分维度。
- 向 /v1/ai-search/llm-brand-metrics POST {"target": "hubspot.com", "platform": "chat_gpt"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 读取 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 查一次,因为回答可能点名品牌却不链接它的网站。
相关 API
除了 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 回答及全部引用来源,可选任意国家和语言。