Historique de l’aperçu - Impressions

API + MCP

GET/v3/brand-radar/impressions-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 (ils diffèrent des identifiants reconnus par le paramètre select).

report_idstring

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

brandstringObligatoire

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

data_sourcestringObligatoire

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: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

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#/...

Valeurs autorisées:ahrefscustom

date_fromstring (date)Obligatoire

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.

date_tostring (date)

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é AI Overview / Mode IA, dérivée des requêtes de recherche Google (mots-clés) plutôt que des prompts.

search_volume_typestring

Une liste de marchés de niche de vos marques, séparés par des virgules. Déprécié le 2026-05-18, ce paramètre n’aura plus d’effet peu après cette date.

Valeurs autorisées:ask_volumekeyword_volume

Par défaut:ask_volume

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

metricsarray<object>

datestring (date)

impressionsinteger

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