REST API galapunkts

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

Vēsturiskie dati pieejami kopš 2026. gada 16. novembra

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.

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