GET /v1/overview | NowMetrix REST API-Dokumentation

Anfrage

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

Diese kompakte Route eignet sich für Trendberichte, BI-Importe, Exporte in Tabellenkalkulationen sowie einfache Wochen- oder Monatszusammenfassungen.

Authentifizierung

Erfordert einen API-Schlüssel im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Abfrageparameter

Name	Typ	Erforderlich	Beschreibung
`site`	`string`	erforderlich	Tracker-ID. Der API-Schlüssel muss Zugriff auf diesen Tracker haben.
`days`	`integer`	optional	Anzahl der zurückzugebenden Tage. Werte werden auf 1–30 begrenzt. Standardwert: 30.

cURL-Beispiel

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

Beispielantwort

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

Antwortfelder

Feld	Typ	Beschreibung
`site`	`string`	Für die Anfrage verwendete Tracker-ID.
`timezone`	`string`	Zeitzone des trackers zur Ermittlung der lokalen Daten.
`range.from`	`string`	Erstes Datum im zurückgegebenen Tages-Array.
`range.to`	`string`	Letztes Datum im zurückgegebenen Tages-Array.
`range.days`	`integer`	Anzahl der zurückgegebenen Tageszeilen.
`daily[]`	`array<object>`	Tageszeilen, aufsteigend nach Datum sortiert.
`daily[].date`	`string`	Datum im Format YYYY-MM-DD.
`daily[].pageviews`	`integer`	Pageviews für dieses Datum.
`daily[].visits`	`integer`	Besuche für dieses Datum.
`totals.pageviews`	`integer`	Summe der Pageviews über alle zurückgegebenen Tageszeilen.
`totals.visits`	`integer`	Summe der Besuche über alle zurückgegebenen Tageszeilen.

Aktualität und Caching

Antworten werden pro Tracker und days-Wert 60 Sekunden zwischengespeichert. Zum Schutz vor Lastspitzen gibt es zusätzlich ein kurzes Zeitfenster, in dem veraltete Antworten ausgeliefert werden können.

Fehler

HTTP	Code	Beschreibung
400	`site_required`	Der erforderliche site-Parameter fehlt.
401	`missing_token`	Der Authorization-Header fehlt.
401	`invalid_token`	Das Token ist ungültig oder wurde widerrufen.
403	`site_not_authorized`	Der API-Schlüssel hat keinen Zugriff auf diesen Tracker.
429	`rate_limit_exceeded`	Das Rate-Limit wurde überschritten.
503	`redis_unavailable`	Das Realtime-Backend ist vorübergehend nicht verfügbar.

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