概要履歴 - メンション
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルタ式。次の列識別子が認識されます（select パラメータで認識される識別子とは異なります）。
履歴期間の終了日（YYYY-MM-DD形式）。
履歴期間の開始日（YYYY-MM-DD形式）。
AIの可視性レポートは、AI調整後ボリュームに切り替わります。これは、チャットボットやAI検索サーフェスにおけるAI回答の需要をより適切に推定します。Googleと比較した各AIプラットフォームの推定利用状況に基づき、Googleの検索ボリュームを調整して算出します。このパラメータは2026年9月30日に廃止予定で、それ以降のすべてのリクエストでは新しいAI調整後ボリュームが使用されます。
2文字の国コード（ISO 3166-1 alpha-2）をカンマで区切ったリスト。
使用するレポートのIDです。指定した場合、他のパラメータ（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 モードでの表示状況をレポートします。
ブランドのニッチ市場をカンマ区切りで指定します。2026-05-18に非推奨となります。その後まもなく、このパラメータは効果を持たなくなります。
検索対象のブランドです。
出力形式。
応答
ブランドに言及した応答から算出された推定メンション数。