REST API-Endpunkt

GET /v1/overview

Täglichi Pageviews und Bsüech für die letschte N abgschlossene Verlaufsziile.

Anfrag

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

Das isch en kompakte Endpoint für Trendbericht, BI-Importe, Tabellenexporte sowie eifachi Wuche- oder Monatszämefassige.

Authentifizierig

Si bruuched en API-Key im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Abfragparameter

Name Typ Erforderlich Beschriibig
site string erforderlich Tracker-ID. De API-Key muess Zuegriff uf dä Tracker ha.
days integer optional Zahl vo de Täg, wo zrugggeh werde. D'Wärt werde uf 1–30 begränzt. Standard: 30.

cURL-Biispil

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

Biispilantwort

{
  "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 Beschriibig
site string Tracker-ID, wo für d'Anfrag verwendet wird.
timezone string Ziitzone vom Tracker, wo zum Bestimme vo de lokale Date verwendet wird.
range.from string Erschts Datum im tägliche Array, wo zrugggeh wird.
range.to string Letschts Datum im tägliche Array, wo zrugggeh wird.
range.days integer Zahl vo de zrugggehne tägliche Ziile.
daily[] array<object> Täglichi Ziile, nach Datum ufsteigend sortiert.
daily[].date string Datum im Format YYYY-MM-DD.
daily[].pageviews integer Pageviews für das Datum.
daily[].visits integer Bsüech für das Datum.
totals.pageviews integer Summe vo de Pageviews über alli zrugggehne tägliche Ziile.
totals.visits integer Summe vo de Bsüech über alli zrugggehne tägliche Ziile.

Aktualität und Caching

Antworte werded pro Tracker und days-Wärt 60 Sekunde lang im Microcache gspeicheret, mit eme churze Stale-Fänschter zum Abfedere vo Lastspitze.

Fähler

HTTP Code Beschriibig
400 site_required De erforderliche site-Parameter fehlt.
401 missing_token De Authorization-Header fehlt.
401 invalid_token De Token isch ungültig oder widerruefe worde.
403 site_not_authorized De API-Key het kei Zuegriff uf dä Tracker.
429 rate_limit_exceeded S Rate-Limit isch überschritte worde.
503 redis_unavailable S Realtime-Backend isch vorübergehend nöd verfüegbar.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}