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
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.
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 ausprobierenAuthentifizierung
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."
}
}