概要 - メンション
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルター式です。次の列識別子が認識されます(select パラメータで認識される識別子とは異なります)。
cited_domain: 応答の生成に使用されたページのドメイン。
型: domain
cited_domain_subdomains: 応答の生成に使用されたページのドメイン。指定したドメインのサブドメインも一致します。
型: string
cited_url_exact: 応答の生成に使用されたページのURL。
型: string
cited_url_prefix: 応答の生成に使用されたページのURL。指定したプレフィックスで始まるURLが一致します。
型: string
question: ユーザーが行った質問。
型: string
response(10ユニット): モデルからの応答。
型: string
search_queries: 応答のための情報を見つける際にチャットボットが使用した検索クエリ。注: data_source に chatgpt または perplexity が含まれていない場合、このフィールドは常に空になります。
型: string
topic: クエリのトピック。
型: string
返却するフィールドのカンマ区切りリスト。利用可能なフィールド: brand、only_target_brand、only_competitors_brands、target_and_competitors_brands、no_tracked_brands、total。
2文字の国コード(ISO 3166-1 alpha-2)のカンマ区切りリスト。
使用するレポートの ID。指定した場合、他のパラメータ(ブランド、競合、マーケット、国、フィルター)はレポートから取得されます。国またはフィルターが指定されている場合は、レポート内の設定よりも優先されます。Ahrefs のブランドレーダー レポートの URL(https://app.ahrefs.com/brand-radar/reports/#report_id#/...)で確認できます。
使用するプロンプトの種類。指定がない場合は両方が使用されます。カスタムプロンプトを使用するには report_id の指定が必要です。
チャットボットモデルのカンマ区切りリスト。Googleのキーワードモデル(google_ai_overviews_keywords、google_ai_mode_keywords)は、互いに、または他のモデルと組み合わせて使用できません。
ブランドのニッチ市場をカンマ区切りで指定したリストです。2026-05-18に非推奨となり、この日付以降まもなくこのパラメータは効果がなくなります。
ブランドの競合のカンマ区切りリスト。
検索対象のブランドのカンマ区切りリスト。brand、competitors、market、where のうち少なくとも 1 つは空にしないでください。
出力形式。
応答
ブランド名(自社ブランド、またはリクエストで指定された競合ブランド)。
指定した市場に関連する応答のうち、提供されたブランドがいずれも言及されていないものからの推定言及数(market が指定されていない場合、値は0)。
競合ブランドのみが言及されている応答からの推定言及数。
自社ブランドのみが言及されている応答からの推定言及数。
自社ブランドと競合ブランドの両方が言及されている応答からの推定言及数。
自社ブランドの推定言及数合計(only_target_brand と target_and_competitors_brands を含む)。