REST-API-Endpunkt

GET /v1/recap

Recap-Daten, zusammenfassende Kennzahlen und Top Pages für Zeitraumvorgaben oder einen benutzerdefinierten Zeitraum.

Anfrage

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

Verwenden Sie Recap, wenn Ihre Integration auf vergangene Daten zugreifen muss: für historische Auswertungen, Exporte von Top Pages, benutzerdefinierte Zeiträume oder durch Suchbegriffe gefilterte Ergebnisse.

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.
preset string optional Zeitraumvorgabe. Eine der folgenden Optionen: today, yesterday, last7, last14, last30, last90, this_month, last_month, custom. Standard: last30.
start date optional Startdatum für preset=custom. Format: YYYY-MM-DD.
end date optional Enddatum für preset=custom. Format: YYYY-MM-DD.
limit integer optional Maximale Anzahl zurückzugebender Top Pages. Werte werden auf 1–100 begrenzt. Standard: 100.
q string optional Suchbegriff für Top Pages. Durchsucht URL, Titel oder Autor. Alias: search.
search string optional Alias für q.

cURL-Beispiel

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

Beispielantwort

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

Antwortfelder

Feld Typ Beschreibung
site string Tracker-ID, die für die Anfrage verwendet wurde.
preset string Für die Antwort ermittelte Zeitraumvorgabe.
timezone string Zeitzone des Trackers, anhand derer die lokalen Daten ermittelt werden.
range object Ermittelter Zeitraum mit Start, Ende, Bezeichnung und Anzahl der Tage.
limits object Für den Tracker verfügbare Grenzen des Datenbestands.
search.query string Normalisierte Suchanfrage, die zur Filterung der Top Pages verwendet wird.
daily[] array<object> Tägliche Pageviews und Besuche für den ermittelten Zeitraum.
summary.total_pageviews integer Pageviews insgesamt über den ermittelten Zeitraum.
summary.total_visits integer Besuche insgesamt über den ermittelten Zeitraum.
summary.pages_per_visitor number Pageviews geteilt durch Besuche, auf eine Dezimalstelle gerundet.
top_pages[] array<object> Nach Pageviews sortierte Top Pages.
top_pages[].rank integer Rang innerhalb der zurückgegebenen Top-Pages-Liste.
top_pages[].title string Titel der Seite.
top_pages[].author string Autor, sofern verfügbar.
top_pages[].pubdate string Veröffentlichungsdatum, sofern verfügbar.
top_pages[].url string Pfad oder verkürzte URL.
top_pages[].url_full string Absolute URL, sofern verfügbar.
top_pages[].url_id string Stabile URL-Kennung.
top_pages[].thumbnail string Thumbnail-URL, sofern verfügbar.
top_pages[].pageviews integer Pageviews für den ermittelten Zeitraum.
generated_at string UTC-Zeitstempel der Payload-Erstellung.

Aktualität und Zwischenspeicherung

Antworten werden pro Tracker, Zeitraumvorgabe, benutzerdefiniertem Zeitraum, Limit und normalisiertem Suchbegriff 60 Sekunden lang zwischengespeichert.

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 Echtzeit-Backend ist vorübergehend nicht verfügbar.
503 clickhouse_unavailable Historische Daten sind vorübergehend nicht verfügbar.
500 encoding_failed Die Recap-Antwort konnte nicht kodiert werden. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}