Krajnja točka REST API-ja

GET /v1/sources-history

Struktura prometa tijekom vremena: prosječan broj istodobnih čitatelja po kategoriji izvora za posljednjih sat vremena, posljednja 24 sata, danas, jučer, posljednjih 7 dana ili prilagođeni datumski raspon.

Zahtjev

Povijest je dostupna od 16. studenoga 2026.

Povijest izvora bilježi se od 16. studenoga 2026. i svakim se danom nadopunjuje. Bilježenje je započelo oko 16:00 UTC, pa su za 16. studenoga dostupni samo večernji sati i dnevna vrijednost nije usporediva s vrijednostima za cijele dane. Ako raspon počinje prije 16. studenoga 2026., vrijednost from pomiče se na taj datum, a odgovor sadrži obavijest; ako raspon završava prije tog datuma, odgovor ne sadrži nijednu točku. Ranija se razdoblja nikad ne prikazuju kao nula.

GET https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today

Ova krajnja točka prikazuje kako se struktura prometa mijenjala tijekom vremena, primjerice kada je počeo promet s Google Discovera ili je li organski promet iz pretraživanja slabiji nego jučer. Svaka točka prikazuje prosječan broj istodobnih čitatelja po kategoriji izvora u tom trenutku. Vrijednosti nisu broj posjeta ni pregleda stranica i ne smiju se zbrajati kroz vrijeme; za ukupne vrijednosti upotrijebite /v1/recap ili /v1/overview. Za pojedinačne izvore prometa uživo, kao što su određena društvena mreža ili e-bilten, upotrijebite /v1/sources.

Isprobati u API Playgroundu

Autentifikacija

Zahtjev mora sadržavati API ključ u zaglavlju Authorization, u obliku: Bearer nm_YOUR_KEY.

Parametri upita

Naziv Vrsta Obavezno Opis
site string obavezno ID trackera. API ključ mora imati pristup tom trackeru.
range string neobavezno Vremenski raspon. Jedna od vrijednosti: 1h (posljednjih 60 minuta, točke u razmacima od 2 minute), 24h (kliznih 24 sata, točke u razmacima od 10 minuta), today i yesterday (kalendarski dan u vremenskoj zoni trackera, točke u razmacima od 10 minuta), 7d (danas i prethodnih 6 dana, satne točke) ili custom (zahtijeva start i end). Zadana vrijednost: today.
start string neobavezno Prvi kalendarski dan prilagođenog raspona u formatu YYYY-MM-DD, prema vremenskoj zoni trackera. Obavezno uz range=custom, a nije dopušteno uz druge raspone. Datum ne smije biti u budućnosti.
end string neobavezno Posljednji kalendarski dan prilagođenog raspona u formatu YYYY-MM-DD, uključivo. Obavezno uz range=custom. Raspon može obuhvaćati najviše 366 dana; ako je datum završetka u budućnosti, raspon se skraćuje do trenutačnog vremena. Razlučivost ovisi o broju dana za koje su podaci zabilježeni: do 2 dana prikazuju se točke u razmacima od 10 minuta, do 31 dana satne točke, a za dulje raspone dnevne točke.

Primjer cURL-a

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

Primjer odgovora

{
  "site": "TRACKER_ID",
  "range": "today",
  "start": null,
  "end": null,
  "timezone": "Europe/Zurich",
  "unit": "avg_concurrent_readers",
  "resolution_minutes": 10,
  "from": "2026-11-18T00:00:00+01:00",
  "to": "2026-11-18T09:24:00+01:00",
  "data_available_from": "2026-11-16",
  "notice": null,
  "updated_at": "2026-11-18T08:24:30+00:00",
  "stale": false,
  "categories": [
    "organic",
    "discover",
    "direct",
    "internal",
    "social",
    "referral",
    "email",
    "ai"
  ],
  "points": [
    {
      "t": "2026-11-18T09:00:00+01:00",
      "total": 412.6,
      "unattributed": 6.4,
      "values": {
        "organic": 96.2,
        "discover": 131.5,
        "direct": 88.1,
        "internal": 41.3,
        "social": 27.9,
        "referral": 12.6,
        "email": 7.2,
        "ai": 1.4
      }
    },
    {
      "t": "2026-11-18T09:10:00+01:00",
      "total": 428.3,
      "unattributed": 5.9,
      "values": {
        "organic": 98.7,
        "discover": 144,
        "direct": 86.4,
        "internal": 42.8,
        "social": 28.5,
        "referral": 12.1,
        "email": 8.6,
        "ai": 1.3
      }
    }
  ]
}

Polja odgovora

Polje Vrsta Opis
site string ID trackera upotrijebljen u zahtjevu.
range string Zatraženi vremenski raspon.
start string|null Zatraženi prvi dan za range=custom, a inače null.
end string|null Zatraženi posljednji dan za range=custom, a inače null.
timezone string Vremenska zona trackera koja se upotrebljava za kalendarske dane i vremenske oznake, primjerice Europe/Zurich.
unit string Uvijek avg_concurrent_readers: prosječan broj čitatelja koji su istodobno aktivni unutar pojedine točke.
resolution_minutes integer Trajanje svake točke u minutama: 2, 10, 60 ili 1440 (jedan kalendarski dan).
from string Početak raspona kao vremenska oznaka ISO 8601 s pomakom vremenske zone trackera. Ako zatraženi raspon počinje prije data_available_from, početak se pomiče na taj datum.
to string Kraj raspona kao vremenska oznaka ISO 8601 s pomakom vremenske zone. Za raspone koji su još u tijeku to je trenutačno vrijeme.
data_available_from string Prvi dan za koji je zabilježena povijest izvora: 2026-11-16. Bilježenje je tog dana započelo oko 16:00 UTC, pa podaci ne obuhvaćaju cijeli dan.
notice object|null Postavljeno ako raspon počinje prije data_available_from; u suprotnom je vrijednost null. Zahtjev se i dalje uspješno obrađuje uz HTTP 200.
notice.code string partial_history: raspon počinje ranije, pa je vrijednost from pomaknuta, a za ranije dane nema točaka. no_history: raspon završava prije početka bilježenja podataka, pa je polje points prazno.
notice.message string Kratko objašnjenje na engleskom jeziku za zapisnike ili prikaz.
updated_at string Vremenska oznaka UTC koja označava kada je povijest izračunata.
stale boolean true ako je riječ o posljednjem valjanom rezultatu jer pozadinski sustav za povijest privremeno nije dostupan.
categories[] array<string> Sve kategorije izvora zadanim redoslijedom: organic, discover, direct, internal, social, referral, email, ai. Popis je uvijek potpun, čak i ako u nekoj kategoriji nije bilo čitatelja.
points[] array<object> Točke kronološkim redoslijedom. Vremena za koja nisu prikupljeni podaci izostavljaju se, pa se mogu pojaviti praznine.
points[].t string Početak točke kao vremenska oznaka ISO 8601 s pomakom vremenske zone. Kad se na kraju ljetnog računanja vremena sat vraća unatrag, ponovljeni sat objedinjuje se u jednu točku.
points[].total number Prosječan broj istodobnih čitatelja iz svih izvora, zaokružen na jednu decimalu.
points[].unattributed number Prosječan broj čitatelja uključenih u total kojima nije moguće dodijeliti kategoriju. Trenutačno je ta vrijednost obično 0, pa je zbroj vrijednosti kategorija jednak vrijednosti total. Udio uvijek izračunajte tako da vrijednost kategorije podijelite s vrijednošću total, kako bi rezultat ostao točan i ako se pojave čitatelji bez dodijeljene kategorije.
points[].values object Prosječan broj istodobnih čitatelja po kategoriji, uz ključeve koji odgovaraju nazivima u polju categories. Za kategorije bez čitatelja vrijednost je 0.

Aktualnost podataka i predmemoriranje

Odgovori se predmemoriraju zasebno za svaki tracker i raspon: 60 sekundi za 1h, 24h i today, 5 minuta za 7d te 30 minuta za yesterday. Prilagođeni rasponi predmemoriraju se zasebno za svaki datum početka i završetka: 30 minuta ako je raspon završio, a inače 60 sekundi za točke u razmacima od 10 minuta te 5 minuta za satne ili dnevne točke. Ako pozadinski sustav za povijest privremeno nije dostupan, vraća se posljednji valjani rezultat s vrijednošću stale: true i zaglavljem Warning. Odgovor sadrži i zaglavlje X-NowMetrix-Microcache s vrijednošću HIT, MISS ili STALE.

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 privremeno nije dostupan.
400 invalid_range Parametar range mora imati vrijednost 1h, 24h, today, yesterday, 7d ili custom.
400 invalid_date_range Nedostaje start ili end, ili datum nije u valjanom formatu YYYY-MM-DD; start je nakon end ili je u budućnosti; raspon obuhvaća više od 366 dana; ili su start i end poslani bez vrijednosti range=custom.
503 source_history_unavailable Povijest izvora privremeno nije dostupna i nijedan nedavni rezultat nije predmemoriran. Ponovite zahtjev nakon vremena navedenog u zaglavlju Retry-After.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}