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 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.
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 PlaygrounduAutentifikacija
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."
}
}