Docs
ドキュメントを検索...⌘K

引用されたページ

API + MCP
GET/v3/brand-radar/cited-pages

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

クエリパラメータ

selectstring必須

返却するフィールドのカンマ区切りリスト。

利用可能なフィールド:
  • responses
  • url
wherestring

フィルター式です。次の列識別子が使用できます(select パラメータで使用できる識別子とは異なります)。

limitinteger

返す結果数です。

デフォルト:1000
datestring (date)

検索対象の日付(YYYY-MM-DD 形式)。

search_volume_typestring

AI可視性レポートは、AI調整済みボリュームへ切り替わります。これは、チャットボットやAI検索サービス全体におけるAI回答の需要をより正確に推定する指標です。Googleの検索ボリュームを、Googleと比較した各AIプラットフォームの推定利用状況に応じて調整することで算出されます。このパラメータは2026年8月31日に非推奨となり、以降はすべてのリクエストで新しいAI調整済みボリュームが使用されます。

許可される値:ask_volumekeyword_volume
デフォルト:ask_volume
countrystring

2文字の国コード(ISO 3166-1 alpha-2)をカンマで区切ったリスト。

許可される値:adaeafagaialamaoarasatauawazba
tracked_urlsstring

追跡対象ページのURLをカンマ区切りで指定します。指定すると、データがない追跡対象URLについても、引用数が0の行がレスポンスに含まれます。

report_idstring

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

promptsstring

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

許可される値:ahrefscustom
data_sourcestring必須

チャットボットモデルをカンマ区切りで指定したリスト。すべてのモデルを相互に組み合わせて使用できます。claude モジュールはカスタムプロンプトのみに対応しています。
google_ai_overviews_keywordsgoogle_ai_mode_keywords の各モデルは、プロンプトではなく Google 検索クエリ(キーワード)に基づく、AIによる概要 / AI モードでの表示状況をレポートします。

許可される値:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
marketstring

ブランドのニッチ市場をカンマ区切りで指定します。2026-05-18に非推奨となります。その後まもなく、このパラメータは効果を持たなくなります。

competitorsstring

ブランドの競合他社をカンマ区切りで指定します。

brandstring

検索するブランドをカンマ区切りで指定します。brand、competitors、market、where のうち少なくとも1つは空でない必要があります。

outputstring

出力形式。

許可される値:jsonphp

応答

pagesarray<object>
mentionsarray<object>

2026-02-10 に非推奨となりました。

responsesinteger

そのページを引用した応答数。

urlstring

引用されたページのURL。

volumeinteger

2026-03-24 に非推奨となりました。