REST API-endpoint

GET /v1/sources

Verkeersbronnen uit het huidige livevenster, met classificatie en optionele onderliggende rijen.

Aanvraag

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

Gebruik dit gerichte endpoint als u wilt weten waar livelezers vandaan komen en niet de volledige realtimepayload voor Toppagina’s nodig hebt.

Authenticatie

Hiervoor is een API-sleutel in de Authorization-header vereist: Authorization: Bearer nm_YOUR_KEY.

Queryparameters

Naam Type Verplicht Beschrijving
site string verplicht Tracker-ID. De API-sleutel moet toegang hebben tot deze tracker.

cURL-voorbeeld

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

Voorbeeldrespons

{
  "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
        }
      ]
    }
  ]
}

Responsvelden

Veld Type Beschrijving
site string Tracker-ID die voor de aanvraag is gebruikt.
updated_at string UTC-tijdstip waarop de payload is gegenereerd.
total_visitors integer Actieve gebruikers die in de uitsplitsing naar bron worden weergegeven.
sources[] array<object> Bronregels, gesorteerd op aantal.
sources[].medium string Broncategorie, bijvoorbeeld search, social, newsletter, (none) of (not set) wanneer utm_source geen utm_medium heeft.
sources[].source string Genormaliseerd bronlabel.
sources[].count integer Aantal actieve gebruikers van deze bron.
sources[].percent integer Afgerond percentage van het totale aantal bezoekers.
sources[].children[] array<object> Optionele detailregels, zoals hostnamen van zoekmachines of campagnenamen.
sources[].children[].label string Label van de onderliggende regel.
sources[].children[].count integer Aantal in de onderliggende regel.

Actualiteit en caching

Responsen worden per tracker 8 seconden in een microcache opgeslagen. De respons bevat ook X-NowMetrix-Microcache met HIT of MISS.

Foutmeldingen

HTTP Code Beschrijving
400 site_required De verplichte parameter site ontbreekt.
401 missing_token De Authorization-header ontbreekt.
401 invalid_token Het token is ongeldig of ingetrokken.
403 site_not_authorized De API-sleutel heeft geen toegang tot deze tracker.
429 rate_limit_exceeded De limiet voor het aantal requests is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}