GET /v1/sources | NowMetrix REST-API-Dokumentation

Anfrage

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

Verwenden Sie diesen spezialisierten Endpunkt, wenn Sie wissen möchten, aus welchen Quellen die Live-Leser kommen, und nicht die vollständigen Realtime-Nutzdaten von Top Pages benötigen.

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.

cURL-Beispiel

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

Beispielantwort

{
  "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	Beschreibung
`site`	`string`	Tracker-ID, die für die Anfrage verwendet wurde.
`updated_at`	`string`	UTC-Zeitstempel, zu dem die Nutzdaten erstellt wurden.
`total_visitors`	`integer`	Aktive Nutzer, die in der Aufschlüsselung nach Quellen enthalten sind.
`sources[]`	`array<object>`	Nach Anzahl sortierte Quellenzeilen.
`sources[].medium`	`string`	Quellenkategorie, zum Beispiel search, social, newsletter, (none) oder (not set), wenn utm_source kein utm_medium enthält.
`sources[].source`	`string`	Normalisierte Quellenbezeichnung.
`sources[].count`	`integer`	Anzahl der aktiven Nutzer aus dieser Quelle.
`sources[].percent`	`integer`	Gerundeter prozentualer Anteil an allen Besuchern.
`sources[].children[]`	`array<object>`	Optionale Detailzeilen, etwa Such-Hostnamen oder Kampagnennamen.
`sources[].children[].label`	`string`	Bezeichnung der untergeordneten Zeile.
`sources[].children[].count`	`integer`	Anzahl der Einträge in der untergeordneten Zeile.

Aktualität und Caching

Antworten werden pro Tracker 8 Sekunden lang als Microcache zwischengespeichert. Die Antwort enthält ausserdem den Header X-NowMetrix-Microcache mit HIT oder MISS.

Fehlermeldungen

HTTP	Code	Beschreibung
400	`site_required`	Der erforderliche site-Parameter 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 Realtime-Backend ist vorübergehend nicht verfügbar.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}