Docs
搜索文档...⌘K

引用概览历史记录

仅限 API
POST/v3/brand-radar/citations-history

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

brands 中提供的每个实体（以及适用时 competitors 中的每个实体）都必须在 url_groups 中至少包含一个值。此处不支持仅包含 names 的实体，因为引用会与 URL 组进行匹配。

请求正文

whereobject

筛选表达式。可识别以下列标识符（这与 select 参数可识别的标识符不同）。

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"]}]}
date_tostring (date)

历史周期的结束日期，格式为 YYYY-MM-DD。

date_fromstring (date)Required

历史周期的开始日期，格式为 YYYY-MM-DD。

search_volume_typestring

AI 可见性报告将切换为 AI 调整后搜索量。它能更准确地估算各类聊天机器人和 AI 搜索平台上对 AI 回答的需求。其计算方式为：根据各 AI 平台相对于 Google 的估计使用量，对 Google 搜索量进行调整。该参数将于 2026 年 8 月 31 日弃用；此后所有请求都将使用新的 AI 调整后搜索量。

允许的值:ask_volumekeyword_volume
Default:ask_volume
countryarray<string>

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

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

要使用的报告 ID。如果提供了报告 ID，其他参数将从报告中获取（market、country、filters）。如果另外提供了 country 或 filters，则会覆盖报告中的对应值。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它：https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

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

允许的值:ahrefscustom
data_sourcearray<string>Required

聊天机器人模型列表。所有模型均可相互组合使用。claude 模块仅支持自定义提示词。

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

品牌细分市场列表。已于 2026-05-18 弃用，此参数将在该日期后不久失效。

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
outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

metricsarray<object>
citationsinteger

根据提及品牌 URL 的响应估算的引用次数。

datestring (date)