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

概要履歴 - メンション

API + MCP
POST/v3/brand-radar/mentions-history

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

brands（該当する場合は competitors も）で指定する各エンティティには、names に少なくとも1つの値を含める必要があります。メンションはブランド名と照合されるため、url_groups のみで構成されるエンティティはここではサポートされていません。

リクエスト本文

whereobject

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

tags_filterobject

プロンプトタグ用のフィルター式です。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"]}]}。

date_tostring (date)

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

date_fromstring (date)Required

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

countryarray<string>

2 文字の国コード（ISO 3166-1 alpha-2）のリスト。

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

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

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

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

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

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

brandsarray<object>

検索対象のブランド名および Web サイトのリスト。

At least one of names or url_groups is required
namesarray<string>

ブランド/競合の名前

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

ターゲットのドメイン

Example:ahrefs.com
scopestringrequired

ターゲットのスコープ。

Allowed values:urlpathdomainsubdomains
outputstring

出力形式。

Allowed values:jsoncsvxmlphp

応答

metricsarray<object>
datestring (date)
mentionsinteger

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