Docs
搜索文档...⌘K

概览历史 - 提及次数

API + MCP
POST/v3/brand-radar/mentions-history

Requests to this endpoint consume API units based on the prompts parameter: requests returning only custom prompt data are free, while requests including Ahrefs prompt data follow standard API unit pricing.

Every entity provided in brands (and competitors, when applicable) must include at least one value in names. Entities consisting only of url_groups are not supported here because mentions are matched against brand names.

请求正文

whereobject

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

tags_filterobject

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

date_tostring (date)

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

date_fromstring (date)Required

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

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

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

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

聊天机器人模型列表。Google 关键词模型（google_ai_overviews_keywords、google_ai_mode_keywords）不能彼此组合，也不能与其他模型组合。

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_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

目标的范围。

Allowed values:urlpathdomainsubdomains
outputstring

输出格式。

Allowed values:jsoncsvxmlphp

响应

metricsarray<object>
datestring (date)
mentionsinteger

基于提及该品牌的响应所估算的提及次数。