Docs
Rechercher dans la documentation...⌘K

Réponses basées sur l’IA

API + MCP
GET/v3/brand-radar/ai-responses

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

selectstringObligatoire

Une liste de champs à renvoyer, séparés par des virgules.

wherestring

Expression de filtrage. Les identifiants de colonnes suivants sont reconnus (ils diffèrent de ceux reconnus par le paramètre select).

limitinteger

Nombre de résultats à renvoyer.

Par défaut:1000
datestring (date)

La date à rechercher au format AAAA-MM-JJ.

search_volume_typestring

Les rapports de visibilité IA passent au volume ajusté pour l’IA. Celui-ci estime mieux la demande de réponses d’IA sur l’ensemble des chatbots et des interfaces de recherche IA. Il est calculé en ajustant le volume de recherche Google en fonction de l’utilisation estimée de chaque plateforme d’IA par rapport à celle de Google. Ce paramètre sera obsolète le 31 août 2026 ; toutes les requêtes utiliseront le nouveau volume ajusté pour l’IA.

Valeurs autorisées:ask_volumekeyword_volume
Par défaut:ask_volume
countrystring

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

Valeurs autorisées:adaeafagaialamaoarasatauawazba
order_bystring

Une colonne selon laquelle trier les résultats.

Valeurs autorisées:relevancevolume
Par défaut:relevance
report_idstring

L’ID du rapport à utiliser. S’il est fourni, les autres paramètres sont repris du rapport (marque, concurrents, marché, pays, filtres). Si le 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#/...

promptsstring

Le type de prompts à utiliser. S’il n’est pas précisé, les deux seront utilisés. Les prompts personnalisés nécessitent de fournir un report_id.

Valeurs autorisées:ahrefscustom
data_sourcestringObligatoire

Une liste de modèles de chatbot séparés par des virgules. 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
Example:chatgpt,perplexity
marketstring

Liste des marchés de niche de vos marques, séparés par des virgules. Déprécié le 18 mai 2026, ce paramètre n’aura plus aucun effet peu après cette date.

competitorsstring

Liste des concurrents de vos marques, séparés par des virgules.

brandstring

Liste des marques à rechercher, séparées par des virgules. Au moins l’un des champs brand, competitors, market ou where ne doit pas être vide.

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

ai_responsesarray<object>
countrystring

Le pays de la question.

data_sourcestring

Le modèle de chatbot qui a généré la réponse.

last_updatedstring (date)

La date à laquelle les données ont été mises à jour pour la dernière fois.

linksarray<object>

(10 unités) Les liens utilisés pour la réponse.

urlstring
titlestring or null
questionstring

La question posée par l’utilisateur.

responsestring

(10 unités) La réponse du modèle.

search_queriesarray<string>

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.

tagsarray<string>

Étiquettes attribuées à la requête.

volumeinteger

(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 ».