GET /api/sites
Liste des sites suivis, avec les visiteurs des 5 dernières et 30 dernières minutes.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/sites"Toutes les données du tableau de bord sont disponibles en JSON (ou en CSV pour les exports). Créez un accès Lecture seule dans Paramètres › Accès : son jeton (zst_…) s’envoie dans l’en-tête Authorization: Bearer …, jamais dans l’adresse. Dans les exemples, remplacez exemple.fr par votre site et gardez le jeton dans une variable d’environnement :
export ZSTATS_TOKEN=zst_…Jours au format AAAA-MM-JJ, heure de Paris. Réponses : 200 (JSON), 400 (paramètre invalide, avec error), 401 (jeton absent ou invalide), 403 (droits insuffisants), 429 (trop de requêtes). Les modifications (objectifs, alertes, paramètres…) sont réservées au jeton administrateur et notées dans le journal d’activité.
/api/sitesListe des sites suivis, avec les visiteurs des 5 dernières et 30 dernières minutes.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/sites"/api/statsToutes les statistiques d’un site sur une période : totaux, pages, provenances, campagnes, pays, appareils, objectifs, parcours, groupes de contenus (groups), classement des contenus (ranking)…
hosting:none = sans hébergeurs ; page:/adresse = visiteurs ayant vu cette page)curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/stats?site=exemple.fr&from=2026-09-01&to=2026-09-30"/api/overviewVue d’ensemble de tous les sites sur une période (totaux et période comparée).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/overview?from=2026-09-01&to=2026-09-30"/api/overview-dailyVisiteurs par jour des 8 sites les plus visités.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/overview-daily?from=2026-09-01&to=2026-09-30"/api/realtimeVisiteurs en ce moment, pages ouvertes, provenances, dernières actions.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/realtime?site=exemple.fr"/api/exportExport CSV d’un tableau (ou de toutes les actions, table=events).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/export?site=exemple.fr&table=pages&from=2026-09-01&to=2026-09-30"/api/explain« Pourquoi ? » : ce qui explique l’écart de visiteurs avec la période comparée.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/explain?site=exemple.fr"/api/forecastProjection du mois en cours.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/forecast?site=exemple.fr"/api/year-over-year12 derniers mois face aux mêmes mois de l’année précédente.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/year-over-year?site=exemple.fr"/api/yearsAnnées superposées : visiteurs et pages vues de chaque mois, par année civile (les 5 dernières au plus) ; null avant le premier mois mesuré et pour les mois à venir.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/years?site=exemple.fr"/api/targetsCaps du mois du site : pour chacun, la mesure (visitors, pageviews ou goal:<id>), le chiffre visé, le chiffre actuel, la part atteinte et la projection à la fin du mois. PUT {metric, value} (administrateur) fixe un cap, value: null le retire.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/targets?site=exemple.fr"/api/page-effectEffet d’un changement sur une page : visiteurs, rebond, défilement, lecture en entier, temps moyen et clics par visiteur, sur les jours d’avant et à partir de la date.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/page-effect?site=exemple.fr&path=/blog/article&day=2026-09-15"/api/decliningContenus en perte de vitesse : pages qui ont perdu au moins 30 % de leurs visiteurs (4 dernières semaines contre les 4 précédentes).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/declining?site=exemple.fr"/api/changesChangements suivis d’un site, avec le jour du bilan (dueDay) et, une fois fait, sa phrase (result). POST {path, day, note?} et DELETE /api/changes/<id> : administrateur.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/changes?site=exemple.fr"/api/pageFiche d’une page sur une période : mesures, visiteurs par jour, provenances, appareils et pays de ses visiteurs, problèmes, changements suivis, objectifs atteints par ses visiteurs (goals : personnes, part, taux de tout le site), période précédente de même durée (previous : visiteurs, vues), navigation interne (flow : pages vues juste avant et juste après ; null = arrivée ou départ).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/page?site=exemple.fr&path=/blog/article&from=2026-09-01&to=2026-09-30"/api/segmentFiche d’un segment : visiteurs d’un pays, d’un appareil ou venus d’une provenance ou d’une campagne — pages d’arrivée et pages vues, engagement, objectifs atteints, appareils et pays.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/segment?site=exemple.fr&dim=country&value=FR&from=2026-09-01&to=2026-09-30"/api/referrerFiche d’une provenance : visiteurs venus de ce site, leurs pages d’arrivée et pages vues, engagement, objectifs atteints, appareils et pays.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/referrer?site=exemple.fr&referrer=google.com&from=2026-09-01&to=2026-09-30"/api/goals/<id>/pathsCe qui mène à un objectif : personnes qui l’ont atteint, pages vues avant en moyenne, pages vues avant (personnes, visiteurs de la page, part qui atteint l’objectif), pages qui y mènent le mieux (best, 20 visiteurs au moins), pages d’arrivée et provenances de ces personnes, personnes par jour (daily).
/api/statscurl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/goals/1/paths?site=exemple.fr&from=2026-09-01&to=2026-09-30"/api/goals/suggestObjectifs suggérés : actions fréquentes des 30 derniers jours (clics, formulaires, téléchargements, événements, pages) qui ne sont pas encore des objectifs, prêtes à envoyer à POST /api/goals.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/goals/suggest?site=exemple.fr"/api/new-pagesNouveaux contenus (pages vues pour la première fois depuis 30 jours) et meilleur moment pour publier (timing).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/new-pages?site=exemple.fr"/api/linksLiens sortants cassés au dernier passage hebdomadaire (POST /api/links/check?site= pour vérifier tout de suite, administrateur).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/links?site=exemple.fr"/api/viewsVues enregistrées du tableau de bord (nom et paramètres de l’adresse). POST {name, query} et DELETE /api/views/<id> : administrateur.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/views"/api/suspiciousTrafic suspect de la période : réseaux sans lecture ni clic qui pèsent lourd dans les pages vues.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/suspicious?site=exemple.fr&from=2026-09-01&to=2026-09-30"/api/campaignsLiens de campagne créés et leurs résultats.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/campaigns?site=exemple.fr"/api/annotationsAnnotations d’un site (et celles communes à tous, site=*).
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/annotations?site=exemple.fr"/api/goalsObjectifs d’un site.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/goals?site=exemple.fr"/api/funnelsParcours de conversion d’un site.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/funnels?site=exemple.fr"/api/meRôle de l’accès utilisé (admin, read, annotate), son nom, et news : numéro de la dernière nouveauté.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/me"/api/news« Quoi de neuf ? » : nouveautés des dernières mises à jour (numéro, jour, titre, points), les plus récentes d’abord.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/news"/api/annotationsAjoute une annotation (◆ sur le graphique), par exemple à chaque mise en ligne.
curl -s -X POST -H "Authorization: Bearer $ZSTATS_TOKEN" \
-d '{"text": "Version 2.3 en ligne"}' \
"https://www.zstats.fr/api/annotations?site=exemple.fr"/api/reports/previewBilan de l’année d’un site (HTML du rapport annuel et son objet), l’année en cours arrêtée à aujourd’hui.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/reports/preview?frequency=yearly&site=exemple.fr&year=2025"/api/login-linksLien de connexion d’un téléphone (url, QR code svg, expiresAt) : à usage unique, valable 5 minutes. Son échange (POST /api/login-links/redeem {code}, sans jeton) crée un accès « Téléphone (QR) … » valable 90 jours.
curl -s -X POST -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/login-links"/api/pushNotifications sur un appareil : clé publique VAPID et appareils abonnés. POST {endpoint, keys: {p256dh, auth}, name} abonne un navigateur (services de notification connus seulement), DELETE {endpoint} le retire, POST /api/push/test envoie un essai.
curl -s -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/push"/api/tokens/phonesDéconnecte tous les téléphones connectés par QR code (révoque leurs accès) ; renvoie {revoked}.
curl -s -X DELETE -H "Authorization: Bearer $ZSTATS_TOKEN" \
"https://www.zstats.fr/api/tokens/phones"/api/share/<jeton>/yearBilan de l’année du site d’un lien de partage (Paramètres › Partage), sans la ligne « À surveiller » ; refusé (403) pour un lien limité à une rubrique. Le lien /share/<jeton>?bilan=AAAA ouvre le tableau de bord sur ce bilan.
curl -s "https://www.zstats.fr/api/share/$ZSTATS_SHARE/year?year=2025"