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
L’expression de filtre. Les identifiants de colonne suivants sont reconnus (cela diffère des identifiants reconnus par le paramètre select).
cited_domain : Le domaine d’une page qui a été utilisée pour générer la réponse.
type : domain
cited_domain_subdomains : Le domaine d’une page qui a été utilisée pour générer la réponse. Tout sous-domaine du domaine indiqué correspondra également.
type : string
cited_url_exact : L’URL d’une page qui a été utilisée pour générer la réponse.
type : string
cited_url_prefix : L’URL d’une page qui a été utilisée pour générer la réponse. Toute URL qui commence par ce préfixe correspondra.
type : string
question : La question posée par l’utilisateur.
type : string
response (10 unités) : La réponse du modèle.
type : string
search_queries : 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.
type : string
topic : Le sujet de la requête.
type : string
Une liste de colonnes, séparées par des virgules, à renvoyer. Voir le Schéma de réponse pour les identifiants de colonne valides.
Nombre de résultats à renvoyer.
La date à rechercher au format AAAA-MM-JJ.
Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2), séparés par des virgules.
Une colonne selon laquelle trier les résultats.
L’ID du rapport à utiliser. Si un ID est fourni, les autres paramètres sont repris depuis le rapport (marque, concurrents, marché, pays, filtres). Si des paramètres de pays ou de 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#/...
Le type de prompts à utiliser. Si non spécifié, les deux types seront utilisés. Les prompts personnalisés nécessitent qu'un report_id soit fourni.
Une liste de modèles de chatbot séparés par des virgules. Les modèles Google (google_ai_overviews, google_ai_mode) ne peuvent pas être combinés entre eux ni avec des modèles non Google.
Une liste, séparée par des virgules, des marchés de niche de vos marques.
Une liste, séparée par des virgules, des concurrents de vos marques.
Une liste de marques à rechercher, séparée par des virgules. Au moins un des champs brand, competitors, market ou where ne doit pas être vide.
Le format de sortie.
Réponses
Le pays de la question.
Le modèle de chatbot qui a généré la réponse.
(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.
É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 ».