GET /v1/sources | NowMetrix REST API

Zahtjev

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

Upotrijebite ovaj namjenski endpoint kada želite saznati odakle dolaze čitatelji uživo, a nije Vam potreban potpuni sadržaj podataka o najpopularnijim stranicama u stvarnom vremenu.

Autentikacija

API ključ mora biti naveden u zaglavlju Authorization: Bearer nm_YOUR_KEY.

Parametri upita

Naziv	Vrsta	Obavezno	Opis
`site`	`string`	obavezno	ID trackera. API ključ mora imati pristup tom trackeru.

Primjer upotrebe cURL-a

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

Primjer odgovora

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

Polja odgovora

Polje	Vrsta	Opis
`site`	`string`	ID trackera upotrijebljen za zahtjev.
`updated_at`	`string`	Vremenska oznaka u UTC-u koja označava kada je odgovor generiran.
`total_visitors`	`integer`	Aktivni korisnici obuhvaćeni raščlambom izvora.
`sources[]`	`array<object>`	Retci s izvorima sortirani prema broju.
`sources[].medium`	`string`	Kategorija izvora, na primjer search, social, newsletter, (none) ili (not set) kada utm_source nema utm_medium.
`sources[].source`	`string`	Normalizirana oznaka izvora.
`sources[].count`	`integer`	Broj aktivnih korisnika iz ovog izvora.
`sources[].percent`	`integer`	Zaokruženi postotak ukupnog broja posjetitelja.
`sources[].children[]`	`array<object>`	Neobavezni detaljni retci, kao što su nazivi hostova za pretraživanje ili nazivi kampanja.
`sources[].children[].label`	`string`	Oznaka podređenog retka.
`sources[].children[].count`	`integer`	Broj u podređenom retku.

Aktualnost i predmemoriranje

Odgovori se po trackeru predmemoriraju na 8 sekundi. Odgovor također uključuje X-NowMetrix-Microcache s vrijednošću HIT ili MISS.

Pogreške

HTTP	Kôd	Opis
400	`site_required`	Nedostaje obavezni parametar site.
401	`missing_token`	Nedostaje zaglavlje Authorization.
401	`invalid_token`	Token nije valjan ili je opozvan.
403	`site_not_authorized`	API ključ nema pristup tom trackeru.
429	`rate_limit_exceeded`	Prekoračeno je ograničenje broja zahtjeva.
503	`redis_unavailable`	Pozadinski sustav za podatke u stvarnom vremenu trenutačno nije dostupan.

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