GET /v1/overview | NowMetrix REST API

Zahtjev

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

Ovo je sažeta ruta za izvješća o trendovima, uvoz u BI sustave, izvoz u proračunske tablice te jednostavne tjedne ili mjesečne sažetke.

Autentikacija

API ključ mora biti naveden u zaglavlju Authorization: Bearer nm_YOUR_KEY.

Parametri upita

Naziv	Vrsta	Obavezno	Opis
`site`	`string`	obavezno	ID trackera. API ključ mora imati pristup tom trackeru.
`days`	`integer`	neobavezno	Broj dana koje treba vratiti. Vrijednosti se ograničavaju na raspon 1–30. Zadano: 30.

Primjer cURL-a

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

Primjer odgovora

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

Polja odgovora

Polje	Vrsta	Opis
`site`	`string`	ID trackera upotrijebljen za zahtjev.
`timezone`	`string`	Vremenska zona trackera koja se upotrebljava za određivanje lokalnih datuma.
`range.from`	`string`	Prvi datum u vraćenom dnevnom nizu.
`range.to`	`string`	Posljednji datum u vraćenom dnevnom nizu.
`range.days`	`integer`	Broj vraćenih dnevnih redaka.
`daily[]`	`array<object>`	Dnevni reci sortirani uzlazno prema datumu.
`daily[].date`	`string`	Datum u formatu YYYY-MM-DD.
`daily[].pageviews`	`integer`	Broj pregleda stranica za navedeni datum.
`daily[].visits`	`integer`	Broj posjeta za navedeni datum.
`totals.pageviews`	`integer`	Zbroj pregleda stranica u vraćenim dnevnim recima.
`totals.visits`	`integer`	Zbroj posjeta u vraćenim dnevnim recima.

Ažurnost i predmemoriranje

Odgovori se pohranjuju u predmemoriju na 60 sekundi, zasebno za svaki tracker i vrijednost parametra days, uz kratko razdoblje posluživanja zastarjelih odgovora radi zaštite od naglih porasta opterećenja.

Pogreške

HTTP	Kôd	Opis
400	`site_required`	Nedostaje obavezni parametar site.
401	`missing_token`	Nedostaje zaglavlje Authorization.
401	`invalid_token`	Token nije valjan ili je opozvan.
403	`site_not_authorized`	API ključ nema pristup tom trackeru.
429	`rate_limit_exceeded`	Ograničenje broja zahtjeva je prekoračeno.
503	`redis_unavailable`	Sustav u pozadini za podatke u stvarnom vremenu trenutačno nije dostupan.

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