REST API-endpoint

GET /v1/overview

Dagelijkse Pageviews en bezoeken voor de laatste N voltooide historische datarijen.

Verzoek

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

Dit is het compacte endpoint voor trendrapporten, BI-imports, spreadsheetexports en eenvoudige wekelijkse of maandelijkse samenvattingen.

Authenticatie

Vereist een API-sleutel in de Authorization-header: Authorization: Bearer nm_YOUR_KEY.

Queryparameters

Naam Type Verplicht Beschrijving
site string verplicht Tracker-ID. De API-sleutel moet toegang hebben tot deze tracker.
days integer optioneel Aantal dagen dat wordt teruggegeven. Waarden worden begrensd op 1–30. Standaardwaarde: 30.

cURL-voorbeeld

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

Voorbeeldrespons

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

Responsvelden

Veld Type Beschrijving
site string Tracker-ID dat voor het verzoek is gebruikt.
timezone string Tijdzone van de tracker die wordt gebruikt om lokale datums te bepalen.
range.from string Eerste datum in de teruggegeven dagelijkse array.
range.to string Laatste datum in de teruggegeven dagelijkse array.
range.days integer Aantal teruggegeven dagelijkse records.
daily[] array<object> Dagelijkse records, oplopend gesorteerd op datum.
daily[].date string Datum in de notatie YYYY-MM-DD.
daily[].pageviews integer Pageviews voor de betreffende datum.
daily[].visits integer Bezoeken voor de betreffende datum.
totals.pageviews integer Som van de Pageviews in de teruggegeven dagelijkse records.
totals.visits integer Som van de bezoeken in de teruggegeven dagelijkse records.

Actualiteit en caching

Responsen worden per tracker en waarde van days 60 seconden in een microcache opgeslagen. Daarnaast is er een korte periode waarin verouderde responsen worden toegestaan om piekbelasting op te vangen.

Foutmeldingen

HTTP Code Beschrijving
400 site_required De verplichte site-parameter ontbreekt.
401 missing_token De Authorization-header ontbreekt.
401 invalid_token Het token is ongeldig of ingetrokken.
403 site_not_authorized De API-sleutel heeft geen toegang tot deze tracker.
429 rate_limit_exceeded De snelheidslimiet is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}