シェア・オブ・ボイス
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルター式。次の列識別子が認識されます（select パラメータで認識される識別子とは異なります）。
使用するレポートのIDです。指定した場合、他のパラメータ（ブランド、競合、マーケット、国、フィルター）はレポートから取得されます。country または filters を指定すると、レポート内の設定よりも優先されます。Ahrefs のブランドレーダーのレポートURLで確認できます: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
検索するブランドをカンマ区切りで指定します。brand、competitors、market、where のうち、少なくとも1つは空でない必要があります。
ブランドの競合をカンマ区切りで指定します。
チャットボットモデルのカンマ区切りリスト。すべてのモデルは組み合わせて使用できます。claude モジュールはカスタムプロンプトのみをサポートします。
google_ai_overviews_keywords および google_ai_mode_keywords モデルは、プロンプトではなく Google 検索クエリ（キーワード）から導出した AIによる概要／AI モードの可視性をレポートします。
2文字の国コード（ISO 3166-1 alpha-2）のカンマ区切りリスト。
使用するプロンプトの種類。指定されていない場合は両方が使用されます。カスタムプロンプトを使用するには report_id を指定する必要があります。
履歴期間の開始日（YYYY-MM-DD形式）。
履歴期間の終了日（YYYY-MM-DD形式）。
出力形式。
応答
（ブランドごとに1単位）ブランドの推定シェア・オブ・ボイス。