REST-API-Endpoint

GET /v1/sources

Traffic-Quälle us em aktuelle Live-Ziitfänschter mit Klassifizierig und optionale Detailziile.

Anfrag

GET https://api.nowmetrix.com/v1/sources?site=TRACKER_ID

Verwänded Si dä spezialisierte Endpoint, wenn Si wüsse wänd, woher d’Live-Läser cho sind und nöd de vollständige Realtime-Payload vo de Top-Siite bruuched.

Authentifizierig

Bruucht en API-Key im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Abfragparameter

Name Typ Erforderlich Beschriibig
site string erforderlich Tracker-ID. Dä API-Key muess Zuegriff uf dä Tracker ha.

cURL-Biispil

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

Biispilantwort

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_visitors": 128,
  "sources": [
    {
      "medium": "search",
      "source": "Google Search",
      "count": 46,
      "percent": 36,
      "children": [
        {
          "label": "google.com",
          "count": 28
        },
        {
          "label": "google.ch",
          "count": 18
        }
      ]
    },
    {
      "medium": "social",
      "source": "social.example",
      "count": 24,
      "percent": 19,
      "children": []
    },
    {
      "medium": "newsletter",
      "source": "morning-briefing",
      "count": 17,
      "percent": 13,
      "children": [
        {
          "label": "daily-edition",
          "count": 11
        },
        {
          "label": "evening-edition",
          "count": 6
        }
      ]
    }
  ]
}

Antwortfelder

Feld Typ Beschriibig
site string Tracker-ID, wo für d’Anfrag verwendet worde isch.
updated_at string UTC-Ziitstempel, wo de Payload generiert worde isch.
total_visitors integer Aktivi Bsuecher, wo i de Quälle-Uufschlüsselig enthalte sind.
sources[] array<object> Quälle-Ziile, nach de Anzahl sortiert.
sources[].medium string Quälle-Kategorie, zum Biispil search, social, newsletter, (none) oder (not set), wenn utm_source kei utm_medium het.
sources[].source string Standardisierti Bezeichnig vo de Quälle.
sources[].count integer Aazahl aktivi Bsuecher vo dere Quälle.
sources[].percent integer Gerundeti Prozäntzahl vo de Gesamtzahl vo Bsuecher.
sources[].children[] array<object> Optionali Detailziile, zum Biispil Such-Hostnames oder Kampagnenname.
sources[].children[].label string Bezeichnig vo de Detailziile.
sources[].children[].count integer Anzahl i de Detailziile.

Aktualität und Caching

Antworte werded pro Tracker 8 Sekunde lang im Microcache gspeicheret. D’Antwort enthält au X-NowMetrix-Microcache mit HIT oder MISS.

Fehler

HTTP Code Beschriibig
400 site_required De erforderliche site-Parameter fehlt.
401 missing_token Dä Authorization-Header fehlt.
401 invalid_token Dä Token isch ungültig oder zruggzoge worde.
403 site_not_authorized Dä API-Key het kei Zuegriff 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. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}