ブランドレーダーのレポート
API のみPOST/v3/management/brand-radar-reports
このエンドポイントへのリクエストは無料で、APIユニットを消費しません。
クエリパラメータ
outputstring
出力形式。
許可される値:jsonphp
リクエスト本文
prompts_frequencyarray<object>
使用するプロンプトの頻度。
data_sourcestringrequired
使用するデータソース。
許可される値:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrok
frequencystringrequired
使用する更新間隔。
許可される値: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
ターゲットのスコープ。
許可される値: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
ターゲットのスコープ。
許可される値:urlpathdomainsubdomains
応答
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
レポートの名前。
errorstring
errorstring
errorstring
errorstring
errorstring