Lire vos données par l'API

Tout ce que montre l'interface est lisible par programme, avec les mêmes filtres et les mêmes périodes.

En bref

Une API de lecture expose vos statistiques au format JSON, avec une clé personnelle. Elle sert à alimenter un tableau de bord interne, un rapport automatisé ou un outil tiers.

Obtenir une clé

Les clés se créent depuis votre profil. Une clé donne accès en lecture à tous les sites de votre compte, et peut être révoquée à tout moment.

Elle s'envoie dans l'en-tête d'autorisation. Ne la publiez pas dans du code exécuté par un navigateur : elle y serait lisible par n'importe qui.

Les points d'entrée

/api/v1/sites liste les sites accessibles et leurs identifiants.
/api/v1/stats renvoie un tableau de bord complet pour un site et une période.
/api/v1/realtime renvoie les visiteurs actifs.

Un appel renvoie un tableau de bord entier, même si vous ne voulez qu'une métrique. Le débit est plafonné : regroupez vos besoins en un appel plutôt que d'en multiplier.

Filtrer

Les filtres se passent en paramètres, sous la forme filters[dimension]=valeur. Les dimensions acceptées sont listées dans la documentation technique.

Une dimension inconnue est ignorée en silence : la réponse arrive complète, sans filtre appliqué et sans erreur. Vérifiez le nom exact de la dimension si vos chiffres paraissent trop élevés.

Il vous manque une réponse ? Écrivez-nous, nous répondons nous-mêmes et nous complétons ce guide.

Poser une question