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.
Corps de la requête
Une liste de champs à renvoyer.
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 noms et de sites web de marques à rechercher.
names or url_groups is requiredLes noms de la marque/du concurrent
Le domaine de la cible
Portée de la cible.
Une liste de noms et de sites web de concurrents à rechercher.
names or url_groups is requiredLes noms de la marque/du concurrent
Le domaine de la cible
Portée de la cible.
Optional phrases used to include or exclude results based on their content.
Only show results containing at least one of these exact phrases.
Hide results containing any of these exact phrases.
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.
Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2).
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.
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.
Expression de filtrage pour la visibilité de votre marque, qui reflète le filtre « Votre marque ». brand_name indique si une réponse mentionne votre marque : "mentioned" ou "not_mentioned". page_status indique la manière dont l’IA a utilisé vos pages : "cited" (l’IA a récupéré des pages de votre site et les a citées dans la réponse), "found_but_not_cited" (l’IA a récupéré des pages de votre site comme sources potentielles, mais ne les a pas citées dans la réponse finale) ou "not_found" (l’IA n’a récupéré aucune page de votre site).
Elle utilise la syntaxe de filtre avec les restrictions suivantes : le seul opérateur valide est "eq" ; chaque champ constitue une section : indiquez une seule valeur ou combinez plusieurs valeurs du même champ avec or ; joignez les sections brand_name et page_status par un and/or au niveau supérieur. La sélection de toutes les valeurs d’un champ est rejetée, car elle correspond à tout (omettez plutôt le champ).
La plage de volume à utiliser comme filtre.
Nécessite date_compared. Ne conserve que les prompts ayant changé selon l’un des critères sélectionnés ici. Les trois colonnes sont combinées avec un OU logique entre elles, tout comme les valeurs au sein de chaque colonne ; ainsi, une colonne omise ou vide n’ajoute rien au filtre, et un objet entièrement vide conserve tous les prompts.
Conserver les prompts auxquels il a été répondu à une seule des deux dates (new, lost) ou aux deux (no_change).
Conserver les prompts pour lesquels l’ensemble de vos propres marques mentionnées dans la réponse a gagné une marque (new), en a perdu une (lost), ou est identique aux deux dates (no_change). Les concurrents ne sont pas pris en compte.
Conserver les prompts pour lesquels l’ensemble de vos propres domaines cités par la réponse a gagné un domaine (new), en a perdu un (lost), ou est identique aux deux dates (no_change). Les concurrents ne sont pas pris en compte.
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 ».