ブランドレーダーのレポート
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 のうち少なくとも1つは空でない必要があります。
推奨。精度の高いターゲティングのために、ブランド名やURLグループを指定できます。
At least one of
names or url_groups is requirednamesarray<string>
ブランド/競合の名前
Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required
ターゲットのドメイン
Example:ahrefs.com
scopestringrequired
ターゲットのスコープ。
Allowed values:urlpathdomainsubdomains
brand
brand、competitors、market のうち少なくとも1つは空でない必要があります。
推奨。精度の高いターゲティングのために、ブランド名やURLグループを指定できます。
At least one of
names or url_groups is requirednamesarray<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
レポートの名前。
errorstring
errorstring
errorstring
errorstring
errorstring