REST API-Endpunkt

GET /v1/sources-history

Traffic-Mix im Zeitverlauf: durchschnittliche Anzahl gleichzeitig aktiver Leserinnen und Leser pro Quellenkategorie für die letzte Stunde, 24 Stunden, heute, gestern, 7 Tage oder einen benutzerdefinierten Zeitraum.

Anfrage

Verlaufsdaten verfügbar ab 16. November 2026

Der Quellenverlauf wird seit dem 16. November 2026 aufgezeichnet und wächst täglich. Die Aufzeichnung begann gegen 16:00 UTC. Deshalb enthält der 16. November nur die Abendstunden; sein Tageswert ist nicht mit vollständigen Tagen vergleichbar. Reicht ein Zeitraum vor den 16. November 2026 zurück, wird «from» auf dieses Datum gesetzt und die Antwort enthält einen Hinweis. Endet ein Zeitraum vor diesem Datum, werden keine Datenpunkte zurückgegeben. Für frühere Zeiträume werden nie Nullwerte ausgewiesen.

GET https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today

Mit diesem Endpunkt sehen Sie, wie sich der Traffic-Mix im Zeitverlauf entwickelt hat – zum Beispiel, wann der Traffic von Google Discover eingesetzt hat oder ob die organische Suche schwächer ist als gestern. Jeder Datenpunkt enthält die durchschnittliche Anzahl gleichzeitig aktiver Leserinnen und Leser pro Quellenkategorie zu diesem Zeitpunkt. Die Werte stehen weder für Besuche noch für Pageviews und dürfen nicht über die Zeit addiert werden. Für Gesamtwerte verwenden Sie /v1/recap oder /v1/overview. Für einzelne Live-Quellen wie ein bestimmtes soziales Netzwerk oder einen Newsletter verwenden Sie /v1/sources.

Im API Playground ausprobieren

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.
range string optional Zeitraum. Möglich sind 1h (letzte 60 Minuten, Datenpunkte im 2-Minuten-Abstand), 24h (rollierende 24 Stunden, Datenpunkte im 10-Minuten-Abstand), today und yesterday (Kalendertag in der Zeitzone des Trackers, Datenpunkte im 10-Minuten-Abstand), 7d (heute und die vorherigen 6 Tage, stündliche Datenpunkte) oder custom (erfordert start und end). Standard: today.
start string optional Erster Kalendertag eines benutzerdefinierten Zeitraums im Format YYYY-MM-DD, angegeben in der Zeitzone des Trackers. Mit range=custom erforderlich und bei anderen Zeiträumen nicht zulässig. Darf nicht in der Zukunft liegen.
end string optional Letzter Kalendertag eines benutzerdefinierten Zeitraums im Format YYYY-MM-DD, einschliesslich dieses Tages. Mit range=custom erforderlich. Ein Zeitraum darf höchstens 366 Tage umfassen; ein Enddatum in der Zukunft wird auf die aktuelle Zeit begrenzt. Die Auflösung richtet sich nach der Anzahl der Tage mit aufgezeichneten Daten: bis zu 2 Tage Datenpunkte im 10-Minuten-Abstand, bis zu 31 Tage stündliche Datenpunkte, bei längeren Zeiträumen tägliche Datenpunkte.

cURL-Beispiel

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"

Beispielantwort

{
  "site": "TRACKER_ID",
  "range": "today",
  "start": null,
  "end": null,
  "timezone": "Europe/Zurich",
  "unit": "avg_concurrent_readers",
  "resolution_minutes": 10,
  "from": "2026-11-18T00:00:00+01:00",
  "to": "2026-11-18T09:24:00+01:00",
  "data_available_from": "2026-11-16",
  "notice": null,
  "updated_at": "2026-11-18T08:24:30+00:00",
  "stale": false,
  "categories": [
    "organic",
    "discover",
    "direct",
    "internal",
    "social",
    "referral",
    "email",
    "ai"
  ],
  "points": [
    {
      "t": "2026-11-18T09:00:00+01:00",
      "total": 412.6,
      "unattributed": 6.4,
      "values": {
        "organic": 96.2,
        "discover": 131.5,
        "direct": 88.1,
        "internal": 41.3,
        "social": 27.9,
        "referral": 12.6,
        "email": 7.2,
        "ai": 1.4
      }
    },
    {
      "t": "2026-11-18T09:10:00+01:00",
      "total": 428.3,
      "unattributed": 5.9,
      "values": {
        "organic": 98.7,
        "discover": 144,
        "direct": 86.4,
        "internal": 42.8,
        "social": 28.5,
        "referral": 12.1,
        "email": 8.6,
        "ai": 1.3
      }
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
site string Für die Anfrage verwendete Tracker-ID.
range string Angefragter Zeitraum.
start string|null Angefragter erster Tag bei range=custom, andernfalls null.
end string|null Angefragter letzter Tag bei range=custom, andernfalls null.
timezone string Zeitzone des Trackers für Kalendertage und Zeitstempel, zum Beispiel Europe/Zurich.
unit string Immer avg_concurrent_readers: durchschnittliche Anzahl der Leserinnen und Leser, die innerhalb eines Datenpunkts gleichzeitig aktiv waren.
resolution_minutes integer Länge jedes Datenpunkts in Minuten: 2, 10, 60 oder 1440 (ein Kalendertag).
from string Beginn des Zeitraums als ISO-8601-Zeitstempel mit Offset der Tracker-Zeitzone. Beginnt der angefragte Zeitraum vor data_available_from, wird dieser Wert auf dieses Datum gesetzt.
to string Ende des Zeitraums als ISO-8601-Zeitstempel mit Offset. Bei laufenden Zeiträumen entspricht dieser Wert der aktuellen Zeit.
data_available_from string Erster Tag mit aufgezeichnetem Quellenverlauf: 2026-11-16. Die Aufzeichnung begann an diesem Tag gegen 16:00 UTC; es handelt sich deshalb um einen unvollständigen Tag.
notice object|null Wird gesetzt, wenn der Zeitraum vor data_available_from zurückreicht, andernfalls null. Die Anfrage ist trotzdem erfolgreich und liefert HTTP 200.
notice.code string partial_history: Der Zeitraum beginnt früher, daher wurde from angepasst und für frühere Tage gibt es keine Datenpunkte. no_history: Der Zeitraum endet vor Beginn der Datenaufzeichnung, daher ist points leer.
notice.message string Kurze Erklärung auf Englisch für Protokolle oder zur Anzeige.
updated_at string UTC-Zeitstempel, der angibt, wann der Verlauf berechnet wurde.
stale boolean true, wenn dies das letzte gültige Ergebnis ist, weil das Backend für Verlaufsdaten kurzzeitig nicht verfügbar ist.
categories[] array<string> Alle Quellenkategorien in fester Reihenfolge: organic, discover, direct, internal, social, referral, email, ai. Die Liste ist immer vollständig, auch wenn es in einer Kategorie keine Leserinnen und Leser gab.
points[] array<object> Datenpunkte in chronologischer Reihenfolge. Zeitpunkte ohne erfasste Daten werden ausgelassen, daher sind Lücken möglich.
points[].t string Beginn des Datenpunkts als ISO-8601-Zeitstempel mit Offset. Wenn die Uhren am Ende der Sommerzeit zurückgestellt werden, werden die beiden Vorkommen der wiederholten Stunde zu einem Datenpunkt zusammengefasst.
points[].total number Durchschnittliche Anzahl gleichzeitig aktiver Leserinnen und Leser über alle Quellen, auf eine Dezimalstelle gerundet.
points[].unattributed number Leserinnen und Leser in total, die keiner Kategorie zugeordnet werden können. Dieser Wert ist derzeit üblicherweise 0, sodass die Kategorien zusammen total ergeben. Berechnen Sie Anteile immer als Kategorienwert geteilt durch total. So bleibt das Ergebnis korrekt, falls nicht zugeordnete Leserinnen und Leser auftreten.
points[].values object Durchschnittliche Anzahl gleichzeitig aktiver Leserinnen und Leser pro Kategorie, mit den Namen aus categories als Schlüssel. Für Kategorien ohne Leserinnen und Leser wird 0 angegeben.

Aktualität und Caching

Antworten werden pro Tracker und Zeitraum zwischengespeichert: 60 Sekunden für 1h, 24h und today, 5 Minuten für 7d und 30 Minuten für yesterday. Benutzerdefinierte Zeiträume werden pro Start- und Enddatum zwischengespeichert: 30 Minuten, wenn der Zeitraum abgeschlossen ist; andernfalls 60 Sekunden bei Datenpunkten im 10-Minuten-Abstand und 5 Minuten bei stündlichen oder täglichen Datenpunkten. Ist das Backend für Verlaufsdaten kurzzeitig nicht verfügbar, wird das letzte gültige Ergebnis mit stale: true und einem Warning-Header zurückgegeben. Die Antwort enthält zudem X-NowMetrix-Microcache mit HIT, MISS oder STALE.

Fehler

HTTP Code Beschreibung
400 site_required Der erforderliche Parameter site 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.
400 invalid_range Der Parameter range muss 1h, 24h, today, yesterday, 7d oder custom sein.
400 invalid_date_range start oder end fehlt oder ist kein gültiges Datum im Format YYYY-MM-DD; start liegt nach end oder in der Zukunft; der Zeitraum umfasst mehr als 366 Tage; oder start und end wurden ohne range=custom übermittelt.
503 source_history_unavailable Der Quellenverlauf ist vorübergehend nicht verfügbar und es ist kein aktuelles Ergebnis im Cache vorhanden. Versuchen Sie es nach Ablauf des Retry-After-Headers erneut.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}