GET /v1/recap

Verwänded Si Recap, wenn Ihri Integration zrugg luege muess: für historischi Berichte, Top-Siite-Exporte, eigeti Ziitrüüm oder Ergebnis, wo Si mit ere Suechi gfiltret händ.

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

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

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

Füeged Si offset=0 dezue, zum d’Pagination z’aktiviere. Jede Antwort enthält höchstens 100 Artikel; de Snapshot enthält höchstens 2000. Ohni Offset oder Snapshot blibed s’bestehendi Antwortformat und Limit unverändert.

Für jedi nöchschti Siite schicked Si pagination.next_offset als Offset und pagination.snapshot_id als Snapshot. Wiederholed Si d’ursprüngliche Parameter site, preset, start, end und search, inklusive eigete Date. Höred Si uf, wenn next_offset null isch. En Offset, wo gliich oder grösser als d’verfüegbari Anzahl isch, git es leeres top_pages-Array zrugg.

D’Reiefolg vo de Artikel, Pageviews, tägliche Wärte, Zämefassig und generated_at blibed über alli Siite fix, au bi Ziitruum, wo hüt enthalted. D’Zämefassigsmetriken beziehnd sich uf de ganze usgwählte Ziitruum; pagination.total zählt nur Artikel im begränzte Snapshot. Jede Aafrag bruucht wiiterhin e gültigi Autorisierig und zählt zum Rate-Limit vom Tracker.

Snapshots laufed nach 10 Minute ab. S Abrüefe vo Siite verlängert die Frist nöd. Bi HTTP 410 verwärfed Si de unvollständige Durchlauf und started Si neu mit offset=0 ohni Snapshot. D’Biispil unde zeiged d’erscht Aafrag, e Fortsetzig und s’zusätzliche Pagination-Objekt.

GET https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=100&offset=0
GET https://api.nowmetrix.com/v1/recap?site=TRACKER_ID&preset=last30&limit=100&offset=100&snapshot=0123456789abcdef0123456789abcdef0123456789abcdef

{
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 2000,
    "max_results": 2000,
    "has_more": true,
    "next_offset": 100,
    "snapshot_id": "0123456789abcdef0123456789abcdef0123456789abcdef",
    "expires_at": "2026-06-26T12:40:00Z"
  }
}

Aafrage ohni Pagination verwänded de bestehende 60-Sekunde-Microcache und de historische Fallback. Bi ere Pagination wird en unveränderliche Snapshot im lokale Stats Redis für 600 Sekunde gspeicheret, mit automatischem Ablauf und ohni gleitendi Verlängerig. Identischi Starts vom gliiche User innerhalb vo 60 Sekunde chönd en Snapshot wiederverwände. Verwänded Si drum expires_at als Frist. Fortsetzige baued d’Date nöd nomal uf und verwänded au kei andere Snapshot als Fallback.

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