ブランドレーダーのレポート
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
内容に基づいて結果を含めたり除外したりするために使用する任意のフレーズ。
includearray<string>
これらの完全一致フレーズのうち、少なくとも1つを含む結果のみを表示します。
excludearray<string>
これらの完全一致フレーズのいずれかを含む結果を非表示にします。
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