概要 - メンション
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルター式。以下の列識別子が認識されます（select パラメータで認識される識別子とは異なります）。
返却するフィールドのカンマ区切りリスト。
AI可視性レポートでは、AI調整後のボリュームに切り替わります。これは、チャットボットやAI検索面全体におけるAI応答の需要を、より適切に推定します。各AIプラットフォームの推定利用量をGoogleと比較し、Googleの検索ボリュームを調整して算出します。このパラメータは2026年9月30日に廃止予定で、すべてのリクエストで新しいAI調整後のボリュームが使用されます。
2文字の国コード（ISO 3166-1 alpha-2）のカンマ区切りリスト。
使用するレポートのID。指定した場合、他のパラメータ（brand、competitors、market、country、filters）はレポートから取得されます。country または filters が指定されている場合は、レポート内の値よりもそれらが優先されます。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 Modeの可視性をレポートします。
ブランドのニッチ市場のカンマ区切りリスト。2026-05-18に非推奨となっており、この日付の後まもなく本パラメータは効果がなくなります。
ブランドの競合のカンマ区切りリスト。
検索するブランドのカンマ区切りリスト。brand、competitors、market、where の少なくとも1つは空であってはなりません。
出力形式。
応答
ブランド名（自社ブランド、またはリクエストで指定された競合ブランド）。
指定した市場に関連する応答のうち、提供されたブランドがいずれも言及されていないものからの推定言及数（market が指定されていない場合、値は0）。
競合ブランドのみが言及されている応答からの推定言及数。
自社ブランドのみが言及されている応答からの推定言及数。
自社ブランドと競合ブランドの両方が言及されている応答からの推定言及数。
自社ブランドの推定言及数合計（only_target_brand と target_and_competitors_brands を含む）。