GET /v1/overview | Documentazione REST API di NowMetrix

Richiesta

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

Questo è l'endpoint essenziale per i report sull'andamento, le importazioni negli strumenti di BI, le esportazioni nei fogli di calcolo e i riepiloghi settimanali o mensili più semplici.

Autenticazione

Richiede una chiave API nell'header Authorization, nel formato Authorization: Bearer nm_YOUR_KEY.

Parametri della query

Nome	Tipo	Obbligatorio	Descrizione
`site`	`string`	obbligatorio	ID del tracker. La chiave API deve avere accesso a questo tracker.
`days`	`integer`	facoltativo	Numero di giorni da restituire. I valori vengono limitati all'intervallo 1-30. Valore predefinito: 30.

Esempio cURL

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

Esempio di risposta

{
  "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
  }
}

Campi della risposta

Campo	Tipo	Descrizione
`site`	`string`	ID del tracker utilizzato per la richiesta.
`timezone`	`string`	Fuso orario del tracker utilizzato per determinare le date locali.
`range.from`	`string`	Prima data nell'array giornaliero restituito.
`range.to`	`string`	Ultima data nell'array giornaliero restituito.
`range.days`	`integer`	Numero di righe giornaliere restituite.
`daily[]`	`array<object>`	Righe giornaliere ordinate per data crescente.
`daily[].date`	`string`	Data nel formato YYYY-MM-DD.
`daily[].pageviews`	`integer`	Pageview per la data indicata.
`daily[].visits`	`integer`	Visite per la data indicata.
`totals.pageviews`	`integer`	Somma dei Pageview nelle righe giornaliere restituite.
`totals.visits`	`integer`	Somma delle visite nelle righe giornaliere restituite.

Aggiornamento e memorizzazione nella cache

Le risposte vengono memorizzate in una microcache per tracker e per valore di days per 60 secondi, con una breve finestra di dati obsoleti per proteggere il sistema dai picchi di richieste.

Errori

HTTP	Codice	Descrizione
400	`site_required`	Manca il parametro site obbligatorio.
401	`missing_token`	Manca l'header Authorization.
401	`invalid_token`	Il token non è valido o è stato revocato.
403	`site_not_authorized`	La chiave API non ha accesso a questo tracker.
429	`rate_limit_exceeded`	È stato superato il limite di richieste.
503	`redis_unavailable`	Il backend realtime non è temporaneamente disponibile.

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