概要 - シェア・オブ・ボイス
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルター式です。次の列識別子が使用できます（select パラメータで使用できる識別子とは異なります）。
AI可視性レポートは、AI調整済みボリュームへ切り替わります。これは、チャットボットやAI検索サービス全体におけるAI回答の需要をより正確に推定する指標です。Googleの検索ボリュームを、Googleと比較した各AIプラットフォームの推定利用状況に応じて調整することで算出されます。このパラメータは2026年8月31日に非推奨となり、以降はすべてのリクエストで新しいAI調整済みボリュームが使用されます。
2文字の国コード（ISO 3166-1 alpha-2）をカンマで区切ったリスト。
使用するレポートのID。指定した場合、他のパラメータ（ブランド、競合、マーケット、国、フィルター）はレポートから取得されます。国またはフィルターを指定した場合は、レポート内の設定を上書きします。AhrefsのブランドレーダーレポートのURLで確認できます： https://app.ahrefs.com/brand-radar/reports/#report_id#/...
使用するプロンプトの種類。指定しない場合は両方が使用されます。カスタムプロンプトを使用するには、report_id の指定が必要です。
チャットボットモデルをカンマ区切りで指定したリスト。すべてのモデルを相互に組み合わせて使用できます。claude モジュールはカスタムプロンプトのみに対応しています。
google_ai_overviews_keywords と google_ai_mode_keywords の各モデルは、プロンプトではなく Google 検索クエリ（キーワード）に基づく、AIによる概要 / AI モードでの表示状況をレポートします。
ブランドのニッチ市場をカンマ区切りで指定します。2026-05-18に非推奨となります。その後まもなく、このパラメータは効果を持たなくなります。
ブランドの競合他社をカンマ区切りで指定します。
検索するブランドをカンマ区切りで指定します。brand、competitors、market、where のうち少なくとも1つは空でない必要があります。
出力形式。
応答
ブランド名（自社ブランド、またはリクエストで指定された競合ブランド）。
自社ブランドの推定シェア・オブ・ボイス。