Docs
搜索文档...⌘K

AI 响应

API + MCP
GET/v3/brand-radar/ai-responses

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

查询参数

selectstring必填

要返回的字段列表,以英文逗号分隔。

wherestring

筛选表达式。支持以下列标识符(注意:这与 select 参数支持的标识符不同)。

report_idstring

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

brandstring

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

competitorsstring

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

data_sourcestring必填

以英文逗号分隔的聊天机器人模型列表。所有模型都可以相互组合。claude 模块仅支持自定义提示词。
google_ai_overviews_keywordsgoogle_ai_mode_keywords 模型报告的 AI Overview / AI Mode 可见性来源于 Google 搜索查询(关键词),而不是提示词。

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
countrystring

由逗号分隔的两位字母国家代码列表(ISO 3166-1 alpha-2)。

允许的值:adaeafagaialamaoarasatauawazba
promptsstring

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

允许的值:ahrefscustom
limitinteger

要返回的结果数量。

默认:1000
datestring (date)

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

date_comparedstring (date)

用于与 date 对比的日期,格式为 YYYY-MM-DD。必须严格早于 date。设置后,报告将涵盖两天中任意一天被回答过的每个提示词,并且 status 字段会报告它们在两天之间的变化情况。仅在 date_compared 有回答、而在 date 没有回答的提示词会被标记为 lost,其余字段将描述它在 date_compared 的响应,因为在 date 没有对应响应。

search_volume_typestring

AI 可见性报告正在切换为使用 AI 调整后的搜索量。它能更好地估算不同聊天机器人与 AI 搜索平台上的 AI 响应需求。其计算方法是:将 Google 搜索量按各 AI 平台相对于 Google 的预估使用量进行调整。此参数将于 2026 年 9 月 30 日弃用;届时所有请求都将使用新的 AI 调整后的搜索量。

允许的值:ask_volumekeyword_volume
默认:ask_volume
order_bystring

用于对结果排序的列。

允许的值:relevancevolume
默认:relevance
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 不包含 chatgptperplexity,该字段将始终为空。

statusstring or null

提示词在 date_compareddate 之间的变化情况。除非设置了 date_compared,否则为 null。new — 在 date 有回答但在 date_compared 没有。lost — 在 date_compared 有回答但在 date 没有;由于在 date 上没有响应,本行其余内容描述的是 date_compared 的响应。no_change — 两个日期都有回答,但这并不表示响应内容本身、其提及或其引用是否发生了变化。

允许的值:newlostno_change
tagsarray<string>

分配给该查询的标签。

volumeinteger

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