Endpoint REST API

GET /v1/sources

Fonti del traffico nella finestra live attuale, con classificazione e righe secondarie facoltative.

Richiesta

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

Usare questo endpoint dedicato per sapere da dove provengono i lettori live, senza richiedere il payload completo delle Pagine principali in tempo reale.

Autenticazione

È necessaria una chiave API nell'intestazione Authorization: Authorization: Bearer nm_YOUR_KEY.

Parametri della query

Nome Tipo Obbligatorio Descrizione
site string obbligatorio ID del tracker. La chiave API deve avere accesso a questo tracker.

Esempio cURL

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

Esempio di risposta

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

Campi della risposta

Campo Tipo Descrizione
site string ID del tracker utilizzato per la richiesta.
updated_at string Timestamp UTC della generazione del payload.
total_visitors integer Utenti attivi rappresentati dalla suddivisione per fonte.
sources[] array<object> Righe delle fonti ordinate per numero di utenti.
sources[].medium string Categoria della fonte, ad esempio search, social, newsletter, (none) o (not set) quando utm_source non include utm_medium.
sources[].source string Etichetta normalizzata della fonte.
sources[].count integer Numero di utenti attivi provenienti da questa fonte.
sources[].percent integer Percentuale arrotondata del totale dei visitatori.
sources[].children[] array<object> Righe di dettaglio facoltative, ad esempio nomi host della ricerca o nomi delle campagne.
sources[].children[].label string Etichetta della riga secondaria.
sources[].children[].count integer Numero di utenti nella riga secondaria.

Aggiornamento e caching

Le risposte vengono memorizzate in una microcache per ciascun tracker per 8 secondi. La risposta include anche X-NowMetrix-Microcache con valore HIT o MISS.

Errori

HTTP Codice Descrizione
400 site_required Manca il parametro site obbligatorio.
401 missing_token Manca l'intestazione Authorization.
401 invalid_token Il token non è valido o è stato revocato.
403 site_not_authorized La chiave API non ha accesso a questo tracker.
429 rate_limit_exceeded È stato superato il limite di richieste.
503 redis_unavailable Il backend in tempo reale non è temporaneamente disponibile. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}