提及

API + MCP

GET/v3/brand-radar/mentions-overview

对此端点的请求会根据 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_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

outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

metricsarray<object>

brandstring

品牌名称（请求中提供的您的品牌或竞争对手品牌）。

entity_typestring

该行是否表示汇总数据、你的目标品牌或竞争对手。

允许的值:aggregatetargetcompetitor

no_tracked_brandsinteger

与指定市场相关的回答中未提及任何所提供品牌的预计提及次数（未指定 market 时该值为 0）。

only_competitors_brandsinteger

仅提及竞争对手品牌的回答带来的预计提及次数。

only_target_brandinteger

仅提及您的品牌的回答带来的预计提及次数。

target_and_competitors_brandsinteger

同时提及您的品牌和竞争对手品牌的回答带来的预计提及次数。

totalinteger

您的品牌的预计提及次数总计（包含 only_target_brand 和 target_and_competitors_brands）。