Docs
搜索文档...⌘K

概览 - 展示次数

API + MCP
GET/v3/brand-radar/impressions-overview

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

查询参数

wherestring

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

cited_domain:用于生成响应的页面域名。
类型:domain

cited_domain_subdomains:用于生成响应的页面域名。所给域名的任何子域名也会匹配。
类型:string

cited_url_exact:用于生成响应的页面 URL。
类型:string

cited_url_prefix:用于生成响应的页面 URL。任何以此前缀开头的 URL 都会匹配。
类型:string

question:用户提出的问题。
类型:string

response(10 个单位):模型的响应内容。
类型:string

search_queries:聊天机器人用于为响应查找信息的搜索查询。注意:如果 data_source 不包含 chatgptperplexity,该字段将始终为空。
类型:string

topic:查询的主题。
类型:string

selectstring必填

要返回的列的逗号分隔列表。有效的列标识符请参见响应 Schema。

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_overviewsgoogle_ai_mode)不能彼此组合,也不能与非 Google 模型组合使用。

允许的值:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
Example:chatgpt,perplexity
marketstring

以逗号分隔的品牌细分市场列表。

competitorsstring

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

brandstring

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

outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

metricsarray<object>
brandstring

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

no_tracked_brandsinteger

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

only_competitors_brandsinteger

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

only_target_brandinteger

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

target_and_competitors_brandsinteger

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

totalinteger

您的品牌的预计展示次数总计(包含 only_target_brandtarget_and_competitors_brands)。