Réponses basées sur l’IA
API + MCPLes 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
Une liste de champs à renvoyer, séparés par des virgules.
L’expression de filtre. Les identifiants de colonne suivants sont reconnus (ils diffèrent des identifiants reconnus par le paramètre select).
L’ID du rapport à utiliser. Si un ID est fourni, les autres paramètres sont repris du rapport (marque, concurrents, marché, pays, filtres). Si le pays ou les 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#/...
Une liste de marques à rechercher, séparées par des virgules. Au moins un des champs brand, competitors, market ou where ne doit pas être vide.
Une liste des concurrents de vos marques, séparés par des virgules.
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.
Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2), séparés par des virgules.
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.
Le nombre de résultats à renvoyer.
La date à rechercher au format YYYY-MM-DD.
Une date à comparer avec date, au format YYYY-MM-DD. Elle doit être strictement antérieure à date. Lorsqu’elle est définie, le rapport couvre chaque prompt ayant reçu une réponse à l’une ou l’autre date, et le champ status indique comment chacun a évolué entre les deux. Un prompt ayant reçu une réponse uniquement à date_compared est indiqué comme lost, et le reste de ses champs décrit sa réponse à date_compared, puisqu’il n’en a aucune à date.
Les rapports de visibilité IA passent au volume ajusté IA. 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 obsolète le 30 septembre 2026 ; toutes les requêtes utiliseront le nouveau volume ajusté IA.
Une colonne selon laquelle trier les résultats.
Le format de sortie.
Réponses
Le pays de la question.
Le modèle de chatbot qui a généré la réponse.
La date à laquelle les données ont été mises à jour pour la dernière fois.
(10 unités) Les liens utilisés pour la réponse.
La question posée par l’utilisateur.
(10 unités) La réponse du modèle.
La requête de recherche utilisée par le chatbot pour trouver des informations pour la réponse. Remarque : si data_source n'inclut pas chatgpt ou perplexity, ce champ sera toujours vide.
Comment le prompt a changé entre date_compared et date. Nul, sauf si date_compared est défini. new — a reçu une réponse à date, mais pas à date_compared. lost — a reçu une réponse à date_compared, mais pas à date ; le reste de cette ligne décrit la réponse à date_compared, puisqu’il n’y en a pas à date. no_change — a reçu une réponse aux deux dates, ce qui ne dit rien sur un éventuel changement de la réponse elle-même, de ses mentions ou de ses citations.
Étiquettes attribuées à la requête.
(10 unités) Volume de recherche mensuel estimé. Cette estimation est basée sur nos données pour Google, en combinant les volumes de recherche de mots-clés associés lorsque cette question apparaît dans la section « Autres questions posées ».