AI 响应

API + MCP

GET/v3/brand-radar/ai-responses

对此端点的请求会根据 prompts 参数消耗 API 单位：仅返回自定义提示数据的请求免费；包含 Ahrefs 提示数据的请求则按标准版 API 单位价格计费。

查询参数

selectstring必填

要返回的字段的逗号分隔列表。

wherestring

筛选表达式。可识别以下列标识符（这与 select 参数可识别的标识符不同）。

limitinteger

要返回的结果数量。

默认:1000

datestring (date)

要搜索的日期，格式为 YYYY-MM-DD。

search_volume_typestring

AI 可见性报告将切换为 AI 调整后搜索量。它能更准确地估算各类聊天机器人和 AI 搜索平台上对 AI 回答的需求。其计算方式为：根据各 AI 平台相对于 Google 的估计使用量，对 Google 搜索量进行调整。该参数将于 2026 年 8 月 31 日弃用；此后所有请求都将使用新的 AI 调整后搜索量。

允许的值:ask_volumekeyword_volume

默认:ask_volume

countrystring

以英文逗号分隔的两位字母国家/地区代码列表（ISO 3166-1 alpha-2）。

允许的值:adaeafagaialamaoarasatauawazba…

order_bystring

用于对结果排序的列。

允许的值:relevancevolume

默认:relevance

report_idstring

要使用的报告 ID。如果提供了该 ID，其他参数将从报告中获取（品牌、竞争对手、市场、国家/地区、筛选条件）。如果提供了国家/地区或筛选条件，则会覆盖报告中的相应设置。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它：https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

要使用的提示词类型。如未指定，将同时使用两者。自定义提示词需要提供 report_id。

允许的值:ahrefscustom

data_sourcestring必填

以逗号分隔的聊天机器人模型列表。所有模型都可相互组合。claude 模块仅支持自定义提示词。
google_ai_overviews_keywords 和 google_ai_mode_keywords 模型报告的是基于 Google 搜索查询（关键词）而非提示词得出的 AI Overview / AI Mode 可见性。

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

以英文逗号分隔的品牌细分市场列表。此参数自 2026-05-18 起弃用，并将在该日期后不久失效。

competitorsstring

以英文逗号分隔的品牌竞争对手列表。

brandstring

以英文逗号分隔的待搜索品牌列表。brand、competitors、market 或 where 中至少有一项不能为空。

outputstring

输出格式。

允许的值:jsonphp

响应

ai_responsesarray<object>

countrystring

问题的国家/地区。

data_sourcestring

生成该回答的聊天机器人模型。

last_updatedstring (date)

数据最后更新的日期。

linksarray<object>

（10 单位）用于生成回答的链接。

urlstring

titlestring or null

questionstring

用户提出的问题。

responsestring

(10 单位) 模型的响应。

search_queriesarray<string>

聊天机器人为生成响应而用于查找信息的搜索查询。注意：如果 data_source 不包含 chatgpt 或 perplexity，该字段将始终为空。

tagsarray<string>

分配给该查询的标签。

volumeinteger

(10 单位) 预计月度搜索量。这基于我们对 Google 的估算，并将相关关键词的搜索量合并计算（当该问题出现在 People Also Ask 栏目中时）。