概览 - 声音份额
API + MCPGET/v3/brand-radar/sov-overview
对此端点的请求会根据
prompts参数消耗 API 单位：仅返回自定义提示数据的请求免费；包含 Ahrefs 提示数据的请求则按标准版 API 单位价格计费。
查询参数
wherestring
筛选表达式。支持以下列标识符（这与 select 参数支持的标识符不同）。
countrystring
由逗号分隔的两字母国家/地区代码列表（ISO 3166-1 alpha-2）。
允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
report_idstring
要使用的报告 ID。如果提供了该值，其他参数将从报告中获取（品牌、竞争对手、市场、国家/地区、筛选条件）。如果提供了国家/地区或筛选条件，它们将覆盖报告中的对应值。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它：https://app.ahrefs.com/brand-radar/reports/#report_id#/...
promptsstring
要使用的提示词类型。如果未指定，将同时使用两者。自定义提示词需要提供 report_id。
允许的值:ahrefscustom
data_sourcestring必填
以逗号分隔的聊天机器人模型列表。Google 关键词模型（google_ai_overviews_keywords、google_ai_mode_keywords）不能彼此组合，也不能与其他模型组合。
允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
marketstring
以英文逗号分隔的品牌细分市场列表。已于 2026-05-18 弃用，此参数将在该日期后不久失效。
competitorsstring
以逗号分隔的品牌竞争对手列表。
brandstring
以逗号分隔的要搜索的品牌列表。brand、competitors、market 或 where 中至少有一个不能为空。
outputstring
输出格式。
允许的值:jsoncsvxmlphp
响应
metricsarray<object>
brandstring
品牌名称（请求中提供的您的品牌或竞争对手品牌）。
share_of_voicenumber (float)
您的品牌的预计声量份额。
errorstring
errorstring
errorstring
errorstring
errorstring