AI の応答
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 形式）。
date と比較する日付（YYYY-MM-DD 形式）。date より厳密に前の日付である必要があります。設定すると、レポートにはいずれかの日付で回答されたすべてのプロンプトが含まれ、status フィールドにはそれぞれが両日間でどのように変化したかが表示されます。date_compared のみに回答があるプロンプトは lost としてレポートされ、それ以外のフィールドには date に回答が存在しないため date_compared のレスポンスが記述されます。
結果の並び替えに使用する列。
出力形式。
応答
回答内にある追跡中ブランドのすべてのメンション（自社ブランドを先に、その後に競合を指定順で）と、それについて回答がどのように述べているか。
言及されている追跡中のブランド。
このメンションで、回答がブランドについてどのように述べているか。利用できない場合は null です。
価格や品質など、このメンションが何についてのものか。利用できない場合は null です。
メンションの前後の文。回答内で見つけられない場合は null です。
質問の国。
回答を生成したチャットボットモデル。
プロンプトのファネルステージ。ファネルステージが利用できない場合は null になります。
プロンプトの意図ラベル（主な意図、サブタイプ、ブランド／ローカル属性など）です。空の配列は、利用可能な意図ラベルがないことを意味します。
データが最後に更新された日付。
（10ユニット）回答に使用されたリンク。
ユーザーが尋ねた質問。
(10単位) モデルからの応答。
チャットボットが応答のための情報を探す際に使用した検索クエリ。注：data_source に chatgpt または perplexity が含まれない場合、このフィールドは常に空になります。
date_compared と date の間でプロンプトがどのように変化したか。date_compared が設定されていない場合は null です。new — date では回答されたが date_compared では回答されなかった。lost — date_compared では回答されたが date では回答されなかった。date には回答がないため、この行の残りは date_compared の応答内容を示します。no_change — 両日とも回答された。これは応答自体、言及、引用が変化したかどうかについては何も示しません。
クエリに付与されたタグ。
(10単位) 推定月間検索数（検索ボリューム）。Google に関する当社推定に基づき、この質問が People Also Ask セクションに表示される関連キーワードの検索ボリュームを合算して算出しています。