Docs
搜索文档...⌘K

Brand Radar 报告

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

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

查询参数

outputstring

输出格式。

允许的值:jsonphp

请求正文

prompts_frequencyarray<object>

要使用的提示词频率。

data_sourcestringrequired

要使用的数据源。

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity
frequencystringrequired

要使用的更新间隔。

Allowed values:dailyweeklymonthlyoff
project_idinteger

要使用的项目 ID。

namestring

报告名称。

marketarray<string>

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

competitors

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

推荐。可指定品牌名称和 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

目标的范围。

Allowed values:urlpathdomainsubdomains
brand

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

推荐。可指定品牌名称和 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

目标的范围。

Allowed values:urlpathdomainsubdomains

响应

reportsarray<object>
created_atstring (date)

报告的创建日期。

project_idinteger or null

报告关联的项目 ID。

prompts_frequencyarray<object>

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

data_sourcestring
frequencystring
report_idstring

报告的唯一标识符。

report_namestring

报告名称。