概要履歴 - メンション
API + MCPこのエンドポイントへのリクエストは、
promptsパラメータに基づいてAPIユニットを消費します。カスタムプロンプトのデータのみを返すリクエストは無料ですが、Ahrefsのプロンプトデータを含むリクエストはスタンダードのAPIユニット料金が適用されます。
クエリパラメータ
フィルター式。次の列識別子が認識されます(select パラメータで認識される識別子とは異なります)。
cited_domain: レスポンス生成に使用されたページのドメイン。
type: domain
cited_domain_subdomains: レスポンス生成に使用されたページのドメイン。指定したドメインのサブドメインも一致します。
type: string
cited_url_exact: レスポンス生成に使用されたページの URL。
type: string
cited_url_prefix: レスポンス生成に使用されたページの URL。このプレフィックスで始まる URL は一致します。
type: string
question: ユーザーが質問した内容。
type: string
response(10 units): モデルからのレスポンス。
type: string
search_queries: レスポンスの情報を見つけるためにチャットボットが使用した検索クエリ。注: data_source に chatgpt または perplexity が含まれていない場合、このフィールドは常に空になります。
type: string
topic: クエリのトピック。
type: string
履歴期間の終了日(YYYY-MM-DD形式)。
履歴期間の開始日(YYYY-MM-DD形式)。
2文字の国コード(ISO 3166-1 alpha-2)をカンマ区切りで指定したリスト。
使用するレポートのID。指定した場合、他のパラメータはレポート(市場、国、フィルター)から取得されます。国またはフィルターが指定されている場合は、レポートの設定よりも優先されます。AhrefsのブランドレーダーのレポートURLで確認できます: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
使用するプロンプトの種類。指定がない場合は両方が使用されます。カスタムプロンプトを使用するには report_id の指定が必要です。
チャットボットモデルのカンマ区切りリスト。Google モデル(google_ai_overviews、google_ai_mode)は、互いに組み合わせることも、Google 以外のモデルと組み合わせることもできません。
ブランドのニッチ市場のカンマ区切りリスト。
検索するブランド。
出力形式。
応答
ブランドに言及した応答から算出された推定メンション数。