Docs
Rechercher dans la documentation...⌘K

Historique de l’aperçu - Mentions

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

Les requêtes adressées à ce point de terminaison consomment des unités d’API en fonction du paramètre prompts : les requêtes qui ne renvoient que des données de prompts personnalisés sont gratuites, tandis que celles qui incluent des données de prompts Ahrefs sont facturées selon la tarification standard des unités d’API.

Chaque entité fournie dans brands (et dans competitors, le cas échéant) doit contenir au moins une valeur dans names. Les entités composées uniquement de url_groups ne sont pas prises en charge ici, car les mentions sont mises en correspondance avec les noms de marque.

Corps de la requête

whereobject

L’expression de filtre. Les identifiants de colonne suivants sont reconnus (ils diffèrent des identifiants reconnus par le paramètre select).

tags_filterobject

Une expression de filtre pour les tags de prompt. Nécessite report_id. Utilise la syntaxe de filtre avec les restrictions suivantes : le seul nom de champ valide est "tag" ; les seuls opérateurs valides sont : "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty" ; la profondeur d'imbrication maximale de and, or est 2. Exemple : {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

date_tostring (date)

Date de fin de la période historique, au format AAAA-MM-JJ.

date_fromstring (date)Required

Date de début de la période historique, au format AAAA-MM-JJ.

countryarray<string>

Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

L’ID du rapport à utiliser. S’il est renseigné, les autres paramètres sont récupérés depuis le rapport (market, country, filters). Si country ou filters sont fournis, ils remplacent ceux du rapport. Vous pouvez le trouver dans l’URL de votre rapport Brand Radar dans Ahrefs : https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Le type de prompts à utiliser. Si non spécifié, les deux types seront utilisés. Les prompts personnalisés nécessitent qu'un report_id soit fourni.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Une liste de modèles de chatbot. Les modèles de mots-clés Google (google_ai_overviews_keywords, google_ai_mode_keywords) ne peuvent pas être combinés entre eux ni avec d’autres modèles.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Une liste des marchés de niche de vos marques. Obsolète depuis le 2026-05-18, ce paramètre n’aura plus d’effet peu après cette date.

brandsarray<object>

Une liste de noms et de sites web de marques à rechercher.

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

Les noms de la marque/du concurrent

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

Le domaine de la cible

Example:ahrefs.com
scopestringrequired

Portée de la cible.

Allowed values:urlpathdomainsubdomains
outputstring

Le format de sortie.

Allowed values:jsoncsvxmlphp

Réponses

metricsarray<object>
datestring (date)
mentionsinteger

Mentions estimées issues de réponses mentionnant la marque.