Docs
搜索文档...⌘K

引用页面

API + MCP
POST/v3/brand-radar/cited-pages

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

请求正文

selectarray<string>Required

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

Example:["field_a","field_b"]
whereobject

筛选表达式。支持以下列标识符(这与 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

tags_filterobject

用于提示词标签的筛选表达式。需要 report_id。使用筛选语法,但有以下限制:唯一有效的字段名为 "tag";唯一有效的运算符为:"eq""neq""substring""isubstring""phrase_match""iphrase_match""prefix""suffix""empty"andor 的最大嵌套深度为 2。示例:{"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}

limitinteger

要返回的结果数量。

Default:1000
datestring

要搜索的日期,格式为 YYYY-MM-DD。

countryarray<string>

两位字母国家/地区代码列表(ISO 3166-1 alpha-2)。

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
tracked_urlsarray<string>

跟踪页面 URL 列表。提供后,对于任何没有数据的跟踪 URL,响应中也会包含其引用次数为 0 的行。

report_idstring

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

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

聊天机器人模型列表。Google 模型(google_ai_overviewsgoogle_ai_mode)不能彼此组合,也不能与非 Google 模型组合使用。

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
marketarray<string>

品牌细分市场列表。

competitorsarray<object>

要搜索的竞争对手名称和网站列表。

At least one of names or url_groups is required
namesarray<string>

品牌/竞争对手的名称

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

目标的域名

Example:ahrefs.com
scopestringrequired

目标的范围。

Allowed values:urlpathdomainsubdomains
brandsarray<object>

要搜索的品牌名称和网站列表。

At least one of names or url_groups is required
namesarray<string>

品牌/竞争对手的名称

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

目标的域名

Example:ahrefs.com
scopestringrequired

目标的范围。

Allowed values:urlpathdomainsubdomains
outputstring

输出格式。

Allowed values:jsonphp

响应

pagesarray<object>
mentionsarray<object>

已于 2026-02-10 弃用。

responsesinteger

引用该页面的响应数量。

urlstring

被引用页面的 URL。

volumeinteger

已于 2026-03-24 弃用。