AI の応答
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
プロンプトタグ用のフィルター式です。report_id が必要です。フィルター構文を使用しますが、次の制限があります。有効なフィールド名は "tag" のみです。有効な演算子は "eq"、"neq"、"substring"、"isubstring"、"phrase_match"、"iphrase_match"、"prefix"、"suffix"、"empty" のみです。and、or の最大ネスト深度は 2 です。例: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}。
返す結果数です。
検索対象の日付(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 以外のモデルと組み合わせることもできません。
ブランドのニッチ市場のリスト。
検索対象の競合名および Web サイトのリスト。
names or url_groups is requiredブランド/競合の名前
ターゲットのドメイン
ターゲットのスコープ。
検索対象のブランド名および Web サイトのリスト。
names or url_groups is requiredブランド/競合の名前
ターゲットのドメイン
ターゲットのスコープ。
出力形式。
応答
質問の国。
回答を生成したチャットボットモデル。
(10ユニット)回答に使用されたリンク。
ユーザーが尋ねた質問。
(10単位) モデルからの応答。
チャットボットが応答のための情報を探す際に使用した検索クエリ。注:data_source に chatgpt または perplexity が含まれない場合、このフィールドは常に空になります。
クエリに付与されたタグ。
(10単位) 推定月間検索数(検索ボリューム)。Google に関する当社推定に基づき、この質問が People Also Ask セクションに表示される関連キーワードの検索ボリュームを合算して算出しています。