GET /v1/sources-history
Traffic-Mix im Ziitverlauf: durchschnittlich gliichziitig aktivi Läser pro Quälle-Kategorie für die letschti Stund, 24 Stunde, hüt, geschter, 7 Täg oder en eigene Ziitruum.
Aafrag
D Verlaufsdate zu de Quälle werded sit em 16. November 2026 uufzeichnet und nähmed täglich zue. D Uufzeichnig het a dem Tag öppe um 16:00 UTC aagfange. Drum sind für de 16. November nume Date vom Abig verfüegbar, und de Tageswert isch nöd mit volle Täg vergliichbar. Wenn en Ziitruum vor em 16. November 2026 aafangt, wird «from» uf das Datum gsetzt und d Antwort enthält en Hiwiis. Endet de Ziitruum vor dem Datum, wird kei Punkt zrugglieferet. Früehneri Zite werded nie als Null usgwiese.
https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today
Mit dem Endpoint gsehnd Si, wie sich de Traffic-Mix im Ziitverlauf entwicklet het – zum Biispil, wenn de Traffic vo Google Discover aagfange het oder d organischi Suechi schwächer isch als geschter. Jede Punkt zeigt d durchschnittlichi Aazahl vo gliichziitig aktive Läser pro Quälle-Kategorie zu dem Ziitpunkt. D Werte sind kei Bsüech und kei Pageviews und dörfed nöd über de Ziitruum zämezellt werde. Für Summe verwänded Si /v1/recap oder /v1/overview. Für einzelni Live-Quälle wie es bestimmts Social Network oder en Newsletter verwänded Si /v1/sources.
Im API Playground uusprobiereAuthentifizierig
D API-Key muess im Authorization-Header mitgschickt werde: Authorization: Bearer nm_YOUR_KEY.
Abfragparameter
| Name | Typ | Erforderlich | Beschriibig |
|---|---|---|---|
site |
string |
erforderlich | Tracker-ID. De API-Key muess Zugriff uf dä Tracker ha. |
range |
string |
optional | Ziitruum. Möglich sind 1h (letschti 60 Minute, Punkt alli 2 Minute), 24h (rollendi 24 Stunde, Punkt alli 10 Minute), today und yesterday (Kalendertag i de Tracker-Ziitzone, Punkt alli 10 Minute), 7d (hüt und die letschte 6 Täg, stündlichi Punkt) oder custom (bruucht start und end). Standard: today. |
start |
string |
optional | Erste Kalendertag vom eigene Ziitruum im Format YYYY-MM-DD, i de Tracker-Ziitzone. Mit range=custom erforderlich und bi andere Ziitruum nöd erlaubt. Darf nöd i de Zuekunft ligge. |
end |
string |
optional | Letschte Kalendertag vom eigene Ziitruum im Format YYYY-MM-DD, inklusive. Mit range=custom erforderlich. En Ziitruum darf höchstens 366 Täg umfasste; es Enddatum i de Zuekunft wird uf d aktuelli Ziit begränzt. D Auflösig richtet sich nach de Anzahl Täg mit uufzeichnete Date: bis 2 Täg Punkt alli 10 Minute, bis 31 Täg stündlichi Punkt, bi längere Ziitruum täglichi Punkt. |
cURL-Biispil
curl -H "Authorization: Bearer nm_YOUR_KEY" \
"https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"
Biispilantwort
{
"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 | Beschriibig |
|---|---|---|
site |
string |
Tracker-ID, wo für d Aafrag verwendet worde isch. |
range |
string |
Afragte Ziitruum. |
start |
string|null |
Afragte erste Tag für range=custom, susch null. |
end |
string|null |
Afragte letschte Tag für range=custom, susch null. |
timezone |
string |
Ziitzone vom Tracker für Kalendertäg und Ziitstempfel, zum Biispil Europe/Zurich. |
unit |
string |
Immer avg_concurrent_readers: durchschnittlichi Aazahl vo Läser, wo innerhalb vo jedem Punkt gliichziitig aktiv sind. |
resolution_minutes |
integer |
Längi vo jedem Punkt i Minute: 2, 10, 60 oder 1440 (en Kalendertag). |
from |
string |
Aafang vom Ziitruum als ISO 8601-Ziitstempfel mit em Ziitzone-Versatz vom Tracker. Wenn de agfragte Ziitruum vor data_available_from aafangt, wird de Aafang uf das Datum gsetzt. |
to |
string |
Ändi vom Ziitruum als ISO 8601-Ziitstempfel mit Versatz. Bi laufende Ziitruum isch das d aktuelli Ziit. |
data_available_from |
string |
Erste Tag mit uufzeichnete Verlaufsdate zu de Quälle: 2026-11-16. D Uufzeichnig het a dem Tag öppe um 16:00 UTC aagfange, drum isch es en unvollständige Tag. |
notice |
object|null |
Wird gsetzt, wenn de Ziitruum vor data_available_from zruggriicht, susch null. D Aafrag isch trotzdem erfolgreich und git HTTP 200 zrugg. |
notice.code |
string |
partial_history: De Ziitruum fangt früener aa. Drum isch from verschobe worde und früehneri Täg händ kei Punkt. no_history: De Ziitruum endet, bevor d Dateuufzeichnig aagfange het. Drum isch points leer. |
notice.message |
string |
Churzi englischi Erlüterig für Logs oder d Aazeig. |
updated_at |
string |
UTC-Ziitstempfel, wo zeigt, wenn de Verlauf berechnet worde isch. |
stale |
boolean |
true, wenn das s letschte gültige Ergebnis isch, will s Verlaufs-Backend churz nöd verfüegbar isch. |
categories[] |
array<string> |
All Quälle-Kategorie i fester Riehefolg: organic, discover, direct, internal, social, referral, email, ai. D Liste isch immer vollständig, au wenn e Kategorie kei Läser gha het. |
points[] |
array<object> |
Pünkt i chronologischer Riehefolg. Zite ohni gsamleti Date werded usgloh, drum chönd Lücke entstah. |
points[].t |
string |
Aafang vom Punkt als ISO 8601-Ziitstempfel mit Versatz. Wenn d Uhr am Ändi vo de Sommerziit zrugggstellt wird, wird d wiederholti Stund zu eim Punkt zämegfasst. |
points[].total |
number |
Durchschnittlichi Aazahl gliichziitig aktive Läser über alli Quälle, uf e Dezimalstell gr rundet. |
points[].unattributed |
number |
Läser i total, wo sich keiner Kategorie zueordne lönd. Im Momänt isch dä Wert normalerwiis 0, drum ergit d Summe vo de Kategorie total. Berechned Si de Aateil immer als Kategorie-Wert geteilt dur total. So stimmt s Ergebnis au, wenn nöd zuegwieseni Läser debii sind. |
points[].values |
object |
Durchschnittlich gliichziitig aktivi Läser pro Kategorie. D Schlüssel sind d Name us categories. Kategorie ohni Läser händ de Wert 0. |
Aktualität und Caching
Antworten werded pro Tracker und Ziitruum gspeicheret: 60 Sekunde für 1h, 24h und today, 5 Minute für 7d und 30 Minute für yesterday. Eigeti Ziitruum werded pro Start- und Enddatum gspeicheret: 30 Minute, wenn de Ziitruum abgschlosse isch, susch 60 Sekunde mit 10-Minute-Pünkt und 5 Minute mit stündliche oder tägliche Pünkt. Wenn s Verlaufs-Backend churz nöd verfüegbar isch, wird s letschte gültige Ergebnis mit stale: true und eme Warning-Header zrugglieferet. D Antwort enthält au X-NowMetrix-Microcache mit HIT, MISS oder STALE.
Fehler
| HTTP | Code | Beschriibig |
|---|---|---|
| 400 | site_required |
De erforderliche Parameter site fehlt. |
| 401 | missing_token |
De Authorization-Header fehlt. |
| 401 | invalid_token |
De Token isch ungültig oder zruggzoge worde. |
| 403 | site_not_authorized |
De API-Key het kei Zugriff uf dä Tracker. |
| 429 | rate_limit_exceeded |
S Rate-Limit isch überschritte worde. |
| 503 | redis_unavailable |
S Realtime-Backend isch vorübergehend nöd verfüegbar. |
| 400 | invalid_range |
De Parameter range muess 1h, 24h, today, yesterday, 7d oder custom sii. |
| 400 | invalid_date_range |
start oder end fehlt oder isch kei gültigs YYYY-MM-DD-Datum; start ligt nach end oder i de Zuekunft; de Ziitruum umfasst meh als 366 Täg; oder start und end sind ohni range=custom gschickt worde. |
| 503 | source_history_unavailable |
D Verlaufsdate zu de Quälle sind vorübergehend nöd verfüegbar und es git kei aktuelle Antwort im Cache. Schicked Si d Aafrag nomal nach de im Retry-After-Header aagebene Ziit. |
{
"error": {
"code": "invalid_token",
"message": "Bearer token is invalid or revoked."
}
}