概览历史 - 声音份额

API + MCP

GET/v3/brand-radar/sov-history

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

查询参数

wherestring

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

report_idstring

历史时间段的结束日期，格式为 YYYY-MM-DD。

brandstring

历史时间段的开始日期，格式为 YYYY-MM-DD。

competitorsstring

AI 可见性报告将切换为 AI 调整后搜索量。它能更好地估算跨聊天机器人和 AI 搜索入口对 AI 响应的需求。其计算方式是：基于各 AI 平台相对于 Google 的预计使用量，对每个平台的 Google 搜索量进行调整。此参数将于 2026 年 9 月 30 日弃用；届时所有请求都将使用新的 AI 调整后搜索量。

data_sourcestring必填

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

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

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

允许的值:adaeafagaialamaoarasatauawazba…

promptsstring

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

允许的值:ahrefscustom

date_fromstring (date)必填

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

date_tostring (date)

由逗号分隔的品牌细分市场列表。已于 2026-05-18 弃用，此参数在该日期后不久将不再生效。

search_volume_typestring

由逗号分隔的品牌竞争对手列表。

允许的值:ask_volumekeyword_volume

默认:ask_volume

outputstring

输出格式。

允许的值:jsonphp

响应

metricsarray<object>

datestring (date)

share_of_voicearray<object>

（每个品牌 1 个单位）该品牌的估算声量份额。

brandstring

share_of_voicenumber (float)