GET /v1/overview | API REST NowMetrix

Requête

GET https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7

Cette route compacte convient aux rapports de tendance, aux importations dans des outils de BI, aux exportations vers des feuilles de calcul et aux synthèses hebdomadaires ou mensuelles simples.

Authentification

Une clé API doit être fournie dans l’en-tête Authorization, avec la valeur Authorization: Bearer nm_YOUR_KEY.

Paramètres de requête

Nom	Type	Obligatoire	Description
`site`	`string`	obligatoire	Tracker ID. La clé API doit donner accès à ce tracker.
`days`	`integer`	facultatif	Nombre de jours à renvoyer. Les valeurs sont limitées à 1–30. Valeur par défaut : 30.

Exemple cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7"

Exemple de réponse

{
  "site": "TRACKER_ID",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-06-20",
    "to": "2026-06-26",
    "days": 7
  },
  "daily": [
    {
      "date": "2026-06-20",
      "pageviews": 81240,
      "visits": 53210
    },
    {
      "date": "2026-06-21",
      "pageviews": 77480,
      "visits": 50195
    },
    {
      "date": "2026-06-22",
      "pageviews": 48215,
      "visits": 31890
    }
  ],
  "totals": {
    "pageviews": 206935,
    "visits": 135295
  }
}

Champs de réponse

Champ	Type	Description
`site`	`string`	Tracker ID utilisé pour la requête.
`timezone`	`string`	Fuseau horaire du tracker utilisé pour déterminer les dates locales.
`range.from`	`string`	Première date du tableau quotidien renvoyé.
`range.to`	`string`	Dernière date du tableau quotidien renvoyé.
`range.days`	`integer`	Nombre de lignes quotidiennes renvoyées.
`daily[]`	`array<object>`	Lignes quotidiennes triées par date croissante.
`daily[].date`	`string`	Date au format YYYY-MM-DD.
`daily[].pageviews`	`integer`	Pages vues pour la date concernée.
`daily[].visits`	`integer`	Visites pour la date concernée.
`totals.pageviews`	`integer`	Somme des pages vues pour les lignes quotidiennes renvoyées.
`totals.visits`	`integer`	Somme des visites pour les lignes quotidiennes renvoyées.

Actualisation et mise en cache

Les réponses sont mises en cache pendant 60 secondes pour chaque tracker et chaque valeur de days, avec une courte période pendant laquelle des réponses obsolètes peuvent être servies afin de protéger le service contre les pics de requêtes.

Erreurs

HTTP	Code	Description
400	`site_required`	Le paramètre site obligatoire est manquant.
401	`missing_token`	L’en-tête Authorization est manquant.
401	`invalid_token`	Le token n’est pas valide ou a été révoqué.
403	`site_not_authorized`	La clé API n’a pas accès à ce tracker.
429	`rate_limit_exceeded`	La limite de débit a été dépassée.
503	`redis_unavailable`	Le backend temps réel est temporairement indisponible.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}