Docs
搜索文档...⌘K

Brand Radar 报告

仅限 API
POST/v3/management/brand-radar-reports

对此端点的请求免费，不会消耗任何 API 单位。

查询参数

outputstring

输出格式。

允许的值:jsonphp

请求正文

brand

brand 或 competitors 中至少有一个必须为非空。

推荐。可指定品牌名称和 URL 组，以实现精准定向。

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
competitors

brand 或 competitors 中至少有一个必须为非空。

推荐。可指定品牌名称和 URL 组，以实现精准定向。

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
namestring

报告名称。

project_idinteger

要使用的项目 ID。

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.

prompts_frequencyarray<object>

要使用的提示词频率。

最小值:1
data_sourcestringrequired

要使用的数据源。

允许的值:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrok
frequencystringrequired

要使用的更新间隔。

允许的值:dailyweeklymonthlyoff

响应

reportsarray<object>
created_atstring (date)

报告的创建日期。

project_idinteger or null

报告关联的项目 ID。

prompts_frequencyarray<object>

一条包含 data_source 字段（可取值：chatgpt、copilot、gemini、google_ai_mode、claude、google_ai_overviews、grok、perplexity）和 frequency 字段（可取值：daily、weekly、monthly、off）的记录。

data_sourcestring
frequencystring
report_idstring

报告的唯一标识符。

report_namestring

报告名称。