Mentions

API + MCP

GET/v3/brand-radar/mentions-history

Les requêtes vers ce point de terminaison consomment des unités d’API en fonction du paramètre prompts : les requêtes ne renvoyant que des données de prompt personnalisé sont gratuites, tandis que les requêtes incluant des données de prompt Ahrefs sont facturées selon la tarification Standard des unités d’API.

Paramètres de requête

wherestring

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

report_idstring

L’ID du rapport à utiliser. Si un ID est fourni, les autres paramètres sont repris du rapport (pays, filtres). Si un pays ou des filtres 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#/...

brandstringObligatoire

La marque à rechercher.

data_sourcestringObligatoire

Une liste de modèles de chatbot séparés par des virgules. Tous les modèles peuvent être combinés entre eux. 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é d’AI Overview / AI Mode, dérivée des requêtes de recherche Google (mots-clés) plutôt que des prompts.

Valeurs autorisées:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2), séparés par des virgules.

Valeurs autorisées:adaeafagaialamaoarasatauawazba…

promptsstring

Le type de prompts à utiliser. Si ce paramètre n’est pas spécifié, les deux seront utilisés. Les prompts personnalisés nécessitent de fournir un report_id.

Valeurs autorisées:ahrefscustom

date_fromstring (date)Obligatoire

La date de début de la période historique au format AAAA-MM-JJ.

date_tostring (date)

La date de fin de la période historique au format AAAA-MM-JJ.

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.