GET /v1/sources-history
Datplūsmas sadalījums laika gaitā: vidējais vienlaikus aktīvo lasītāju skaits katrā avotu kategorijā pēdējā stundā, pēdējās 24 stundās, šodien, vakar, pēdējās 7 dienās vai pielāgotā datumu diapazonā.
Pieprasījums
Avotu vēstures datus reģistrē kopš 2026. gada 16. novembra, un to apjoms katru dienu pieaug. Datu reģistrēšana sākās ap plkst. 16.00 UTC, tāpēc par 16. novembri pieejami tikai vakara dati un šīs dienas rādītājus nevar salīdzināt ar pilnām dienām. Ja diapazons sākas pirms 2026. gada 16. novembra, parametra from vērtība tiek pārcelta uz šo datumu, un atbildē tiek iekļauts paziņojums; ja diapazons beidzas pirms šī datuma, netiek atgriezts neviens datu punkts. Agrākie periodi nekad netiek uzrādīti kā nulles vērtības.
https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today
Izmantojiet šo galapunktu, lai aplūkotu, kā laika gaitā mainījies datplūsmas sadalījums, piemēram, kad sāka pienākt datplūsma no Google Discover vai vai organiskās meklēšanas datplūsma ir mazāka nekā vakar. Katrā datu punktā norādīts vidējais vienlaikus aktīvo lasītāju skaits katrā avotu kategorijā attiecīgajā laikā. Šīs vērtības nav apmeklējumu vai lapu skatījumu skaits, un tās nedrīkst summēt laika gaitā; kopskaitiem izmantojiet /v1/recap vai /v1/overview. Lai iegūtu datus par atsevišķiem avotiem reāllaikā, piemēram, konkrētu sociālo tīklu vai informatīvo izdevumu, izmantojiet /v1/sources.
Izmēģināt API izmēģināšanas vidēAutentifikācija
Nepieciešama API atslēga Authorization galvenē: Authorization: Bearer nm_YOUR_KEY.
Vaicājuma parametri
| Nosaukums | Veids | Obligāts | Apraksts |
|---|---|---|---|
site |
string |
obligāts | Tracker ID. API atslēgai jānodrošina piekļuve šim trackerim. |
range |
string |
neobligāts | Laika diapazons. Iespējamās vērtības: 1h (pēdējās 60 minūtes, datu punkti ik pēc 2 minūtēm), 24h (slīdošs 24 stundu periods, datu punkti ik pēc 10 minūtēm), today un yesterday (kalendārā diena tracker laika joslā, datu punkti ik pēc 10 minūtēm), 7d (šodiena un iepriekšējās 6 dienas, datu punkti reizi stundā) vai custom (nepieciešami start un end). Noklusējuma vērtība: today. |
start |
string |
neobligāts | Pielāgotā diapazona pirmā kalendārā diena formātā YYYY-MM-DD tracker laika joslā. Obligāts, ja norādīts range=custom, un nav atļauts citiem diapazoniem. Datums nedrīkst būt nākotnē. |
end |
string |
neobligāts | Pielāgotā diapazona pēdējā kalendārā diena formātā YYYY-MM-DD, ieskaitot norādīto datumu. Obligāts, ja norādīts range=custom. Diapazons nedrīkst pārsniegt 366 dienas; nākotnes beigu datums tiek saīsināts līdz pašreizējam laikam. Datu punktu detalizācija ir atkarīga no diapazona, par kuru ir reģistrēti dati: līdz 2 dienām — ik pēc 10 minūtēm, līdz 31 dienai — reizi stundā, ilgākam periodam — reizi dienā. |
cURL piemērs
curl -H "Authorization: Bearer nm_YOUR_KEY" \
"https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"
Atbildes piemērs
{
"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
}
}
]
}
Atbildes lauki
| Lauks | Veids | Apraksts |
|---|---|---|
site |
string |
Pieprasījumā izmantotais Tracker ID. |
range |
string |
Pieprasītais laika diapazons. |
start |
string|null |
Pieprasītā pirmā diena, ja norādīts range=custom; citos gadījumos — null. |
end |
string|null |
Pieprasītā pēdējā diena, ja norādīts range=custom; citos gadījumos — null. |
timezone |
string |
Tracker laika josla, kas izmantota kalendāro dienu un laika zīmogu noteikšanai, piemēram, Europe/Zurich. |
unit |
string |
Vienmēr avg_concurrent_readers: vidējais vienlaikus aktīvo lasītāju skaits katrā datu punktā. |
resolution_minutes |
integer |
Katra datu punkta ilgums minūtēs: 2, 10, 60 vai 1440 (viena kalendārā diena). |
from |
string |
Diapazona sākums kā ISO 8601 laika zīmogs ar tracker laika joslas nobīdi. Ja pieprasītais diapazons sākas pirms data_available_from, sākuma laiks tiek pārcelts uz šo datumu. |
to |
string |
Diapazona beigas kā ISO 8601 laika zīmogs ar laika joslas nobīdi. Ja diapazons vēl turpinās, norādīts pašreizējais laiks. |
data_available_from |
string |
Pirmā diena, par kuru reģistrēta avotu vēsture: 2026-11-16. Datu reģistrēšana šajā dienā sākās ap plkst. 16.00 UTC, tāpēc šī ir nepilna diena. |
notice |
object|null |
Norādīts, ja diapazons sniedzas pirms data_available_from; citos gadījumos — null. Pieprasījums joprojām tiek veiksmīgi izpildīts un atgriež HTTP 200. |
notice.code |
string |
partial_history: diapazons sākas agrāk, tāpēc from vērtība tika pārcelta un par agrākajām dienām nav datu punktu. no_history: diapazons beidzas pirms datu reģistrēšanas sākuma, tāpēc points ir tukšs. |
notice.message |
string |
Īss skaidrojums angļu valodā žurnālfailiem vai attēlošanai. |
updated_at |
string |
UTC laika zīmogs, kas norāda, kad aprēķināta vēsture. |
stale |
boolean |
true, ja šis ir pēdējais derīgais rezultāts, jo vēstures datu sistēma īslaicīgi nav pieejama. |
categories[] |
array<string> |
Visas avotu kategorijas noteiktā secībā: organic, discover, direct, internal, social, referral, email, ai. Sarakstā vienmēr ir visas kategorijas, arī tad, ja kādā no tām nav bijis neviena lasītāja. |
points[] |
array<object> |
Datu punkti hronoloģiskā secībā. Laiki, par kuriem dati nav iegūti, tiek izlaisti, tāpēc iespējami pārtraukumi. |
points[].t |
string |
Datu punkta sākums kā ISO 8601 laika zīmogs ar laika joslas nobīdi. Kad beidzas vasaras laiks un pulksteņi tiek pagriezti atpakaļ, atkārtotā stunda tiek apvienota vienā datu punktā. |
points[].total |
number |
Vidējais vienlaikus aktīvo lasītāju skaits no visiem avotiem, noapaļots līdz vienai zīmei aiz komata. |
points[].unattributed |
number |
Lasītāji, kas iekļauti total vērtībā, bet nav pieskaitīti nevienai kategorijai. Pašlaik šī vērtība parasti ir 0, tāpēc kategoriju vērtību summa ir vienāda ar total. Lai aprēķinātu īpatsvaru, vienmēr daliet kategorijas vērtību ar total; tā rezultāts būs pareizs arī tad, ja būs lasītāji bez noteiktas kategorijas. |
points[].values |
object |
Vidējais vienlaikus aktīvo lasītāju skaits katrā kategorijā; kategorijas norādītas ar categories saraksta vērtībām. Kategorijām, kurās nav lasītāju, vērtība ir 0. |
Datu aktualitāte un kešatmiņa
Atbildes tiek saglabātas kešatmiņā katram trackerim un diapazonam atsevišķi: 60 sekundes diapazoniem 1h, 24h un today, 5 minūtes diapazonam 7d un 30 minūtes diapazonam yesterday. Pielāgotu diapazonu atbildes tiek saglabātas kešatmiņā atbilstoši sākuma un beigu datumam: 30 minūtes, ja diapazons ir beidzies; ja tas vēl turpinās — 60 sekundes, ja datu punkti ir ik pēc 10 minūtēm, vai 5 minūtes, ja tie ir stundu vai dienu intervālos. Ja vēstures datu sistēma īslaicīgi nav pieejama, tiek atgriezts pēdējais derīgais rezultāts ar stale: true un Warning galveni. Atbildē ir arī X-NowMetrix-Microcache galvene ar vērtību HIT, MISS vai STALE.
Kļūdas
| HTTP | Kods | Apraksts |
|---|---|---|
| 400 | site_required |
Nav norādīts obligātais site parametrs. |
| 401 | missing_token |
Nav norādīta Authorization galvene. |
| 401 | invalid_token |
Token nav derīgs vai ir atsaukts. |
| 403 | site_not_authorized |
API atslēga nenodrošina piekļuvi šim trackerim. |
| 429 | rate_limit_exceeded |
Pārsniegts pieprasījumu skaita ierobežojums. |
| 503 | redis_unavailable |
Reāllaika datu sistēma īslaicīgi nav pieejama. |
| 400 | invalid_range |
Parametra range vērtībai jābūt 1h, 24h, today, yesterday, 7d vai custom. |
| 400 | invalid_date_range |
Nav norādīts start vai end, vai arī datums nav derīgs YYYY-MM-DD formātā; start ir pēc end vai atrodas nākotnē; diapazons pārsniedz 366 dienas; vai arī start un end ir norādīti bez range=custom. |
| 503 | source_history_unavailable |
Avotu vēsture īslaicīgi nav pieejama, un kešatmiņā nav nesena rezultāta. Atkārtojiet pieprasījumu pēc Retry-After galvenē norādītā laika. |
{
"error": {
"code": "invalid_token",
"message": "Bearer token is invalid or revoked."
}
}