REST-API-Endpoint

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

Verlaufsdate ab em 16. November 2026 verfüegbar

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.

GET 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 uusprobiere

Authentifizierig

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