Docs
搜索文档...⌘K

引用域名

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

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

请求正文

selectarray<string>Required

要返回的字段列表。

可用字段：
  • domain
  • pages
  • responses
Example:["field_a","field_b"]
whereobject

筛选表达式。支持以下列标识符（注意：这与 select 参数支持的标识符不同）。

report_idstring

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

brandsarray<object>

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

Default:[]
At least one of names or url_groups is required
namesarray<string>

品牌/竞争对手的名称

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

目标对象的域名

Example:ahrefs.com
scopestringrequired

目标对象的范围。

允许的值:urlpathdomainsubdomains
competitorsarray<object>

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

Default:[]
At least one of names or url_groups is required
namesarray<string>

品牌/竞争对手的名称

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

目标对象的域名

Example:ahrefs.com
scopestringrequired

目标对象的范围。

允许的值:urlpathdomainsubdomains
content_filterobject

Optional phrases used to include or exclude results based on their content.

includearray<string>

Only show results containing at least one of these exact phrases.

excludearray<string>

Hide results containing any of these exact phrases.

data_sourcearray<string>Required

聊天机器人模型列表。所有模型都可相互组合。claude 模块仅支持自定义提示词。
google_ai_overviews_keywords 和 google_ai_mode_keywords 模型报告的是基于 Google 搜索查询（关键词）而非提示词得出的 AI Overview / AI Mode 可见性。

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
countryarray<string>

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

允许的值:adaeafagaialamaoarasatauawazba…
Default:[]
promptsstring

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

允许的值:ahrefscustom
limitinteger

要返回的结果数量。

Default:1000
datestring (date)

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

search_volume_typestring

AI 可见性报告正在切换为使用 AI 调整后的搜索量。它能更好地估算不同聊天机器人与 AI 搜索平台上的 AI 响应需求。其计算方法是：将 Google 搜索量按各 AI 平台相对于 Google 的预估使用量进行调整。此参数将于 2026 年 9 月 30 日弃用；届时所有请求都将使用新的 AI 调整后的搜索量。

允许的值:ask_volumekeyword_volume
Default:ask_volume
tags_filterobject

用于筛选提示词标签的表达式。必须提供 report_id。使用 筛选语法，但须遵守以下限制：唯一有效的字段名是 "tag"；有效运算符仅包括："eq"、"neq"、"substring"、"isubstring"、"phrase_match"、"iphrase_match"、"prefix"、"suffix"、"empty"；and 和 or 的最大嵌套深度为 2。

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
brand_filterobject

用于筛选品牌可见度的表达式，对应“Your brand”筛选器。brand_name 用于匹配回答是否提及你的品牌："mentioned" 或 "not_mentioned"。page_status 用于匹配 AI 对你网页的使用方式："cited"（AI 从你的网站检索了网页，并在回答中引用了这些网页）、"found_but_not_cited"（AI 从你的网站检索了网页作为潜在来源，但未在最终回答中引用），或 "not_found"（AI 未从你的网站检索到任何网页）。
使用 筛选语法，但须遵守以下限制：唯一有效的运算符是 "eq"；每个字段对应一个部分：可以提供单个值，也可以用 or 组合同一字段的多个值；使用顶层 and/or 连接 brand_name 和 page_status 部分。如果选择某个字段的所有值，请求会被拒绝，因为这会匹配所有内容（应改为省略该字段）。

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}
volume_rangeobject

用于按搜索量范围进行筛选。

frominteger
tointeger
outputstring

输出格式。

允许的值:jsonphp

响应

domainsarray<object>
domainstring

被引用的域名。

mentionsarray<object>

已于 2026-02-10 弃用。

pagesinteger

在响应中引用该域名的唯一页面数量。

responsesinteger

引用该域名的响应数量。

volumeinteger

已于 2026-03-24 弃用。