インプレッション

API + MCP

GET/v3/brand-radar/impressions-history

このエンドポイントへのリクエストは、prompts パラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。

クエリパラメータ

wherestring

フィルター式です。以下のカラム識別子が認識されます（select パラメータで認識される識別子とは異なります）。

report_idstring

使用するレポートの ID。指定した場合、他のパラメータ（国、フィルター）はレポートから取得されます。国またはフィルターを指定した場合は、それらがレポート内の設定を上書きします。Ahrefs のブランドレーダーレポートの URL で確認できます：https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring必須

検索対象のブランド。

data_sourcestring必須

チャットボットモデルのカンマ区切りリスト。すべてのモデルは組み合わせて使用できます。claude モジュールはカスタムプロンプトのみをサポートします。
google_ai_overviews_keywords および google_ai_mode_keywords モデルは、プロンプトではなく Google 検索クエリ（キーワード）から導出した AIによる概要／AI モードの可視性をレポートします。

許可される値:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

2文字の国コード（ISO 3166-1 alpha-2）のカンマ区切りリスト。

許可される値:adaeafagaialamaoarasatauawazba…

promptsstring

使用するプロンプトの種類。指定されていない場合は両方が使用されます。カスタムプロンプトを使用するには report_id を指定する必要があります。

許可される値:ahrefscustom

date_fromstring (date)必須

履歴期間の開始日（YYYY-MM-DD形式）。

date_tostring (date)

履歴期間の終了日（YYYY-MM-DD形式）。

search_volume_typestring

AI 可視性レポートは AI 調整後ボリュームへ移行しています。これにより、チャットボットや AI 検索サーフェス全体における AI レスポンスの需要をより適切に推定できます。Google と比較した各 AI プラットフォームの推定利用状況に基づき、Google の検索ボリュームを調整して算出します。このパラメータは 2026 年 9 月 30 日に非推奨となり、以降すべてのリクエストで新しい AI 調整後ボリュームが使用されます。

許可される値:ask_volumekeyword_volume

デフォルト:ask_volume

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

metricsarray<object>

datestring (date)

impressionsinteger

ブランドに言及している応答からの推定インプレッション数。