Trafic IA et agents
Ce que l’IA envoie réellement vers votre site : le trafic référent couvre les visiteurs humains venus des assistants IA, le trafic des agents couvre les crawlers IA qui sollicitent votre serveur d’origine.
GET/metrics/ai_traffic
Renvoie le trafic provenant de l’IA mesuré par l’outil d’analyse web connecté au projet (Google Analytics 4, Adobe Analytics, PostHog, Plausible ou Piano) : utilisateurs, sessions et conversions par jour, regroupés par source IA (ChatGPT, Perplexity, Gemini, Claude et autres), avec les totaux et un taux de conversion. Nécessite le forfait Scale ou supérieur et un outil connecté ; un projet sans outil connecté renvoie ERR_AI_TRAFFIC_NOT_CONNECTED (404).
project_idobligatoirerangefromtogranularityday|week|monthsourcelimite à une seule source IA
GET/web_analytics/schema
Décrit comment interroger en direct l’outil d’analyse web connecté au projet : quel outil et quelle propriété, le format de requête natif qu’il accepte, les champs de premier niveau autorisés, les règles appliquées par cet endpoint, un exemple complet et, lorsque l’outil le permet, sa liste de champs en direct (toutes les dimensions et métriques GA4, définitions personnalisées comprises, les ID de dimensions et de métriques Adobe, les méthodes de rapport Matomo, les événements PostHog récents, le catalogue Plausible). Résultat mis en cache pendant une heure. Contrairement à /metrics/ai_traffic, qui renvoie les chiffres de trafic référent IA déjà enregistrés par la synchronisation Trafic IA, ces endpoints interrogent directement l’outil. Les projets sans outil connecté renvoient ERR_WEB_ANALYTICS_NOT_CONNECTED (404). Disponible à partir du forfait Growth. MCP : get_web_analytics_schema.
project_idobligatoire
POST/web_analytics/query
Exécute une requête en direct et en lecture seule sur l’outil d’analyse web connecté au projet, et renvoie des colonnes et des lignes. Rédigez la requête dans le format propre à l’outil : un corps runReport de la GA4 Data API, une requête de rapport Adobe Analytics ou Customer Journey Analytics, des paramètres de la Matomo Reporting API (méthodes get uniquement), du HogQL PostHog, une requête Plausible Stats API v2 ou un corps getData Piano. La propriété, le site, la suite de rapports ou le projet connecté est toujours utilisé, et tout champ de propriété présent dans la requête est ignoré. Le nombre de lignes est de 100 par défaut et plafonné à 5 000 ; les requêtes identiques sont servies depuis un cache de 10 minutes (cached: true). Une requête refusée par l’outil renvoie ERR_WEB_ANALYTICS_INVALID_QUERY (422) avec le message de validation de l’outil. Chaque requête hors cache consomme le quota d’API de l’outil, partagé avec la synchronisation du trafic IA, et un projet autorise 20 requêtes hors cache par minute (ERR_WEB_ANALYTICS_UPSTREAM, 503, avec Retry-After). Disponible à partir du forfait Growth ; aucune clé avec droit d’écriture n’est requise. MCP : query_web_analytics.
- Corps JSON :
project_id(obligatoire),query(obligatoire) : l’objet de requête natif ou, pour PostHog, la chaîne HogQL ou{"query": "SELECT ..."}.
GET/metrics/agent_traffic
Trafic agrégé des bots IA d’un projet, regroupé par bot ou par entreprise, avec une granularité quotidienne, hebdomadaire ou mensuelle.
project_idobligatoirerangefromtobotcompanygroup_bybot|companygranularityday|week|month
GET/dimensions/agent_bots
Catalogue statique des bots IA que le module Agent Analytics sait identifier. Utilisez-le pour construire des filtres fidèles à notre classification interne (slug, nom affiché, société, catégorie, correspondance avec les bots vérifiés de Cloudflare). Nécessite le forfait Scale ou supérieur ; l’outil MCP list_agent_bots est disponible à partir du forfait Scale.
project_idobligatoire mais ignoré : le catalogue est le même pour tous les projets