展示量
API + MCPGET/v3/brand-radar/impressions-history
对此端点的请求会根据
prompts参数消耗 API 单位：仅返回自定义提示数据的请求免费；包含 Ahrefs 提示数据的请求则按标准版 API 单位价格计费。
查询参数
wherestring
过滤表达式。支持以下列标识符（这与 select 参数支持的标识符不同）。
report_idstring
要使用的报告 ID。如果提供该值，其他参数将从报告中获取（国家/地区、筛选条件）。如果另外提供了国家/地区或筛选条件，它们将覆盖报告中的设置。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它：https://app.ahrefs.com/brand-radar/reports/#report_id#/...
brandstring必填
要搜索的品牌。
data_sourcestring必填
以英文逗号分隔的聊天机器人模型列表。所有模型都可以相互组合。claude 模块仅支持自定义提示词。
google_ai_overviews_keywords 和 google_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
date_fromstring (date)必填
历史时间段的开始日期，格式为 YYYY-MM-DD。
date_tostring (date)
历史时间段的结束日期，格式为 YYYY-MM-DD。
outputstring
输出格式。
允许的值:jsoncsvxmlphp
响应
metricsarray<object>
datestring (date)
impressionsinteger
提及该品牌的回答带来的预计展示次数。
errorstring
errorstring
errorstring
errorstring
errorstring