概要履歴 - メンション

API + MCP

GET/v3/brand-radar/mentions-history

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

クエリパラメータ

wherestring

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

date_tostring (date)

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

date_fromstring (date)必須

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

countrystring

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

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

promptsstring

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

許可される値:ahrefscustom

data_sourcestring必須

チャットボットモデルのカンマ区切りリスト。Googleのキーワードモデル（google_ai_overviews_keywords、google_ai_mode_keywords）は、互いに、または他のモデルと組み合わせて使用できません。

許可される値:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

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

brandstring必須

検索するブランド。

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

metricsarray<object>

datestring (date)

mentionsinteger

ブランドに言及した応答から算出された推定メンション数。