REST API

Bringen Sie NowMetrix-Daten in die Tools, die Ihr Team bereits nutzt.

Starten Sie mit einem Live-Snapshot, erstellen Sie eine Anzeige für den Newsroom oder übertragen Sie historische Ergebnisse in Ihren Reporting-Workflow. Wählen Sie hier einen Endpoint aus und öffnen Sie anschliessend die vollständige technische Referenz.

Anwendung verbinden

Neu bei der API? Beginnen Sie mit der vollständigen Anleitung zum Herstellen der Verbindung. Sie erklärt, wie Sie einen API-Key erstellen und schützen, ihn mit /api/me überprüfen und dieselbe authentifizierte Anfrage aus gängigen Programmiersprachen senden.

Verbindungsanleitung öffnen

Mit einer Basis-URL starten

Jede mit einem API-Key authentifizierte Anfrage beginnt mit diesem Host:

https://api.nowmetrix.com

API-Key senden

Senden Sie einen API-Key als Bearer-Token im Authorization-Header. Kontoadministratoren und Teammitglieder mit API-Zugriff können im NowMetrix-Dashboard unter Einstellungen -> API bis zu 10 aktive Keys erstellen und beschriften.

Authorization: Bearer nm_YOUR_KEY

HTTPS ist erforderlich. Alle Keys verwenden die Berechtigungen des zugehörigen NowMetrix-Benutzers und teilen das Rate-Limit des jeweiligen trackers.

Erste Anfrage senden

Am schnellsten testen Sie Ihre Einrichtung mit einem Realtime-Snapshot. Damit bestätigen Sie, dass der Key funktioniert und auf den Tracker zugreifen kann.

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

Benötigte Daten auswählen

Methode Pfad Beschreibung Referenz
GET /v1/realtime Aktueller Live-Snapshot: Live-Leser, Pageviews, Top Pages, Geräte, Länder, Städte und Quellen. Endpoint anzeigen
GET /v1/sources Besucherquellen aus dem aktuellen Live-Zeitfenster mit Klassifizierung und optionalen untergeordneten Zeilen. Endpoint anzeigen
GET /v1/overview Tägliche Pageviews und Besuche für die letzten N abgeschlossenen historischen Zeilen. Endpoint anzeigen
GET /v1/recap Recap-Daten, zusammenfassende Kennzahlen und Top Pages für vordefinierte oder benutzerdefinierte Zeiträume. Endpoint anzeigen
GET /v1/pulse Pulse für heute, Vergleich mit gestern und untertägige Kurven in 15-Minuten-Intervallen. Endpoint anzeigen
GET /v1/proofreading Bis zu 100 aktuell sichtbare Vorschläge der Textprüfung aus den zuletzt geprüften Artikeln eines trackers. Endpoint anzeigen
GET /v1/responsibilities Aktuelle Zuständigkeiten des Teams für einen Tracker, einschliesslich der Personen, die den jeweils sichtbaren Rollen zugewiesen sind. Endpoint anzeigen
GET /api/me Kontokontext des API-Keys: aktueller Tracker und alle Tracker, auf die der Token zugreifen kann. Endpoint anzeigen

Für schnelle und planbare Anfragen sorgen

Die öffentliche API erlaubt 20 Anfragen pro Minute und Tracker. Mehrere Benutzer oder Keys, die denselben Tracker abfragen, teilen sich denselben Zähler.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42
Speichern Sie API-Antworten nach Möglichkeit in Ihrem eigenen System zwischen. Als Faustregel gilt: Cachen Sie Realtime-Daten nur kurz und historische Übersichts­daten mehrere Minuten.

Wenn eine Anfrage fehlschlägt

Sie sollten nicht für jedes Problem ein anderes Format verarbeiten müssen. API-Fehler verwenden einen einheitlichen JSON-Body mit einem stabilen, maschinenlesbaren Code.

HTTP Code Beschreibung
400 site_required Der erforderliche site-Parameter fehlt.
401 missing_token Der Authorization-Header fehlt.
401 invalid_token Der Token ist ungültig oder wurde widerrufen.
403 site_not_authorized Der API-Key hat keinen Zugriff auf diesen Tracker.
429 rate_limit_exceeded Das Rate-Limit wurde überschritten.
503 redis_unavailable Das Realtime-Backend ist vorübergehend nicht verfügbar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}