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).

report_idstring

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

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>

The names of the brand/competitor

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

The domain of the target

Example:ahrefs.com
scopestringrequired

Scope of the target.

Valeurs autorisées:urlpathdomainsubdomains
data_sourcearray<string>Required

Une liste de modèles de chatbot. Tous les modèles peuvent être combinés les uns avec les autres. Le module claude ne prend en charge que les prompts personnalisés.
Les modèles google_ai_overviews_keywords et google_ai_mode_keywords indiquent la visibilité dans AI Overviews / le mode IA, déterminée à partir de requêtes de recherche Google (mots-clés) plutôt que de prompts.

Valeurs autorisées:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
countryarray<string>

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

Valeurs autorisées:adaeafagaialamaoarasatauawazba…
Default:[]
promptsstring

Le type de prompts à utiliser. S’il n’est pas spécifié, les deux seront utilisés. Les prompts personnalisés nécessitent qu’un report_id soit fourni.

Valeurs autorisées:ahrefscustom
date_fromstring (date)Required

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

date_tostring (date)

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

search_volume_typestring

Les rapports de visibilité IA passent au volume IA ajusté. Il estime mieux la demande de réponses IA sur l’ensemble des chatbots et des surfaces de recherche IA. Il est calculé en ajustant le volume de recherche Google en fonction de l’utilisation estimée de chaque plateforme IA par rapport à Google. Ce paramètre sera déprécié le 30 septembre 2026 ; toutes les requêtes utiliseront le nouveau volume IA ajusté.

Valeurs autorisées:ask_volumekeyword_volume
Default:ask_volume
tags_filterobject

Expression de filtrage pour les étiquettes 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 des opérateurs and et or est de 2.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

metricsarray<object>
datestring (date)
mentionsinteger

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