ブランドレーダーのレポート
API のみPOST/v3/management/brand-radar-reports
このエンドポイントへのリクエストは無料で、APIユニットを消費しません。
クエリパラメータ
outputstring
出力形式。
許可される値:jsonphp
リクエスト本文
brand
brand または competitors の少なくとも一方は、空でないことが必須です。
推奨。精度の高いターゲティングのために、ブランド名や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
competitors
brand または competitors の少なくとも一方は、空でないことが必須です。
推奨。精度の高いターゲティングのために、ブランド名や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
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
レポートの名前。
errorstring
errorstring
errorstring
errorstring
errorstring