GET /v1/overview | Dokumentace NowMetrix REST API

Požadavek

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

Tento endpoint poskytuje přehledná data pro sledování trendů, import do nástrojů BI, export do tabulek a jednoduché týdenní či měsíční souhrny.

Autentizace

Vyžaduje klíč API v hlavičce Authorization ve tvaru: Authorization: Bearer nm_YOUR_KEY.

Parametry dotazu

Název	Typ	Povinné	Popis
`site`	`string`	povinné	ID trackeru. Klíč API musí mít k tomuto trackeru přístup.
`days`	`integer`	volitelné	Počet dnů, které se mají vrátit. Hodnota se omezí na 1–30. Výchozí hodnota: 30.

Příklad cURL

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

Příklad odpovědi

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

Pole odpovědi

Pole	Typ	Popis
`site`	`string`	ID trackeru použité v požadavku.
`timezone`	`string`	Časové pásmo trackeru použité pro určení místních dat.
`range.from`	`string`	První datum ve vráceném poli denních údajů.
`range.to`	`string`	Poslední datum ve vráceném poli denních údajů.
`range.days`	`integer`	Počet vrácených denních řádků.
`daily[]`	`array<object>`	Denní řádky seřazené vzestupně podle data.
`daily[].date`	`string`	Datum ve formátu YYYY-MM-DD.
`daily[].pageviews`	`integer`	Zobrazení stránek za dané datum.
`daily[].visits`	`integer`	Návštěvy za dané datum.
`totals.pageviews`	`integer`	Součet zobrazení stránek ve vrácených denních řádcích.
`totals.visits`	`integer`	Součet návštěv ve vrácených denních řádcích.

Aktuálnost a mezipaměť

Odpovědi se pro každý tracker a hodnotu days ukládají do mezipaměti na 60 sekund. Pro ochranu před nárazovým zatížením se používá také krátké období, během kterého lze vracet zastaralá data.

Chyby

HTTP	Kód	Popis
400	`site_required`	Chybí povinný parametr site.
401	`missing_token`	Chybí hlavička Authorization.
401	`invalid_token`	Token je neplatný nebo byl odvolán.
403	`site_not_authorized`	Klíč API nemá k tomuto trackeru přístup.
429	`rate_limit_exceeded`	Byl překročen limit požadavků.
503	`redis_unavailable`	Backend Realtime je dočasně nedostupný.

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