REST API-endpoint

GET /v1/recap

Recapgegevens, samenvattende statistieken en Toppagina’s voor presets of een aangepast datumbereik.

Aanvraag

GET https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=25

Gebruik Recap wanneer uw integratie historische gegevens, exports van Toppagina’s, aangepaste datumbereiken of met een zoekterm gefilterde resultaten nodig heeft.

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.
preset string optioneel Vooraf ingestelde periode. Een van today, yesterday, last7, last14, last30, last90, this_month, last_month, custom. Standaard: last30.
start date optioneel Begindatum voor preset=custom. Indeling: YYYY-MM-DD.
end date optioneel Einddatum voor preset=custom. Indeling: YYYY-MM-DD.
limit integer optioneel Maximumaantal Toppagina’s dat wordt teruggegeven. Waarden worden begrensd op 1–100. Standaard: 100.
q string optioneel Zoekterm voor Toppagina’s. Doorzoekt de URL, titel en auteur. Alias: search.
search string optioneel Alias voor q.

cURL-voorbeeld

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=25"

Voorbeeldresponse

{
  "site": "TRACKER_ID",
  "preset": "last30",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-05-28",
    "to": "2026-06-26",
    "label": "Last 30 Days",
    "days": 30
  },
  "limits": {
    "min_date": "2025-03-17",
    "max_date": "2026-06-26",
    "max_days": null
  },
  "search": {
    "query": ""
  },
  "daily": [
    {
      "date": "2026-06-25",
      "pageviews": 102400,
      "visits": 12800
    },
    {
      "date": "2026-06-26",
      "pageviews": 98450,
      "visits": 12130
    }
  ],
  "summary": {
    "total_pageviews": 3158127,
    "total_visits": 388450,
    "pages_per_visitor": 8.1
  },
  "top_pages": [
    {
      "rank": 1,
      "title": "Home page",
      "author": "",
      "pubdate": "",
      "url": "/",
      "url_full": "https://example-media.test/",
      "url_id": "5dc0a5883395e2a126e5239650d9268e",
      "thumbnail": "https://realtimemetadata.fra1.cdn.digitaloceanspaces.com/thumbnails/example.jpg",
      "pageviews": 159280
    },
    {
      "rank": 2,
      "title": "Culture desk live notes",
      "author": "Alex Morgan",
      "pubdate": "2026-06-24",
      "url": "/culture/live-notes",
      "url_full": "https://example-media.test/culture/live-notes",
      "url_id": "b35c1a5f2fd0cbb7f3c13b853c2a9d2c",
      "thumbnail": "https://realtimemetadata.fra1.cdn.digitaloceanspaces.com/thumbnails/example-2.jpg",
      "pageviews": 85632
    }
  ],
  "generated_at": "2026-06-26T12:30:00Z"
}

Responsevelden

Veld Type Beschrijving
site string Tracker-ID die voor de aanvraag is gebruikt.
preset string De toegepaste preset voor deze response.
timezone string Tijdzone van de tracker die is gebruikt om lokale datums te bepalen.
range object Het vastgestelde datumbereik met from, to, label en het aantal dagen.
limits object Beschikbare limieten voor historische gegevens van de tracker.
search.query string Genormaliseerde zoekopdracht die voor het filteren van Toppagina’s is gebruikt.
daily[] array<object> Dagelijkse Pageviews en bezoeken voor het vastgestelde datumbereik.
summary.total_pageviews integer Totaal aantal Pageviews binnen het vastgestelde datumbereik.
summary.total_visits integer Totaal aantal bezoeken binnen het vastgestelde datumbereik.
summary.pages_per_visitor number Pageviews gedeeld door bezoeken, afgerond op één decimaal.
top_pages[] array<object> Toppagina’s, gesorteerd op Pageviews.
top_pages[].rank integer Positie binnen de teruggegeven lijst met Toppagina’s.
top_pages[].title string Paginatitel.
top_pages[].author string Auteur, indien beschikbaar.
top_pages[].pubdate string Publicatiedatum, indien beschikbaar.
top_pages[].url string Pad of verkorte URL.
top_pages[].url_full string Absolute URL, indien beschikbaar.
top_pages[].url_id string Stabiele URL-identificatie.
top_pages[].thumbnail string Thumbnail-URL, indien beschikbaar.
top_pages[].pageviews integer Aantal Pageviews binnen het vastgestelde datumbereik.
generated_at string UTC-tijdstip waarop de payload is gegenereerd.

Actualiteit en caching

Responses worden 60 seconden in de microcache bewaard per tracker, preset, aangepast datumbereik, limiet en genormaliseerde zoekterm.

Foutmeldingen

HTTP Code Beschrijving
400 site_required De verplichte parameter site 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 limiet voor aanvragen is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar.
503 clickhouse_unavailable Historische gegevens zijn tijdelijk niet beschikbaar.
500 encoding_failed De Recap-response kon niet worden gecodeerd. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}