Docs
搜索文档...⌘K

引用页面

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

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

查询参数

selectstring必填

要返回的字段列表,以逗号分隔。

可用字段:
  • responses
  • title
  • url
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
limitinteger

要返回的结果数量。

默认:1000
datestring (date)

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

tracked_urlsstring

以逗号分隔的已跟踪页面 URL 列表。提供后,对于没有数据的任何已跟踪 URL,响应会包含引用次数为 0 的行。

outputstring

输出格式。

允许的值:jsonphp

响应

pagesarray<object>
mentionsarray<object>

已于 2026-02-10 弃用。

responsesinteger

引用该页面的响应数量。

titlestring or null

在 AI 响应引用中显示的页面标题;如果没有响应记录,则为抓取到的页面标题。如果两者都未知,则为 null。

urlstring

被引用页面的 URL。

volumeinteger

已于 2026-03-24 弃用。