Endpoint REST API

GET /v1/sources-history

Zmiany miksu ruchu w czasie: średnia liczba równoczesnych czytelników w poszczególnych kategoriach źródeł z ostatniej godziny, 24 godzin, dzisiaj, wczoraj, 7 dni lub wybranego zakresu dat.

Żądanie

Dane historyczne dostępne od 16 listopada 2026 r.

Historia źródeł jest rejestrowana od 16 listopada 2026 r. i każdego dnia przybywa nowych danych. Rejestrowanie rozpoczęło się około 16:00 UTC, dlatego dane z 16 listopada obejmują tylko godziny wieczorne i ich dzienna wartość nie jest porównywalna z wartościami dla pełnych dni. Jeśli zakres sięga przed 16 listopada 2026 r., parametr from zostaje ustawiony na tę datę, a odpowiedź zawiera informację. Zakres kończący się przed tą datą nie zwraca żadnych punktów. Wcześniejsze wartości nigdy nie są przedstawiane jako zero.

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

Ten endpoint pozwala sprawdzić, jak zmieniał się miks ruchu, na przykład kiedy pojawił się ruch z Google Discover lub czy ruch z wyszukiwarek jest mniejszy niż wczoraj. Każdy punkt zawiera średnią liczbę równoczesnych czytelników w poszczególnych kategoriach źródeł w danym czasie. Wartości nie oznaczają wizyt ani odsłon i nie należy ich sumować w czasie; aby uzyskać wartości łączne, należy użyć /v1/recap lub /v1/overview. Aby uzyskać dane o poszczególnych źródłach w czasie rzeczywistym, takich jak konkretna sieć społecznościowa lub newsletter, należy użyć /v1/sources.

Wypróbuj w API Playground

Uwierzytelnianie

Wymagany jest klucz API w nagłówku Authorization: Bearer nm_YOUR_KEY.

Parametry zapytania

Nazwa Typ Wymagane Opis
site string wymagany Identyfikator trackera. Klucz API musi mieć dostęp do tego trackera.
range string opcjonalny Zakres czasu. Jedna z wartości: 1h (ostatnie 60 minut, punkty co 2 minuty), 24h (ruchome 24 godziny, punkty co 10 minut), today i yesterday (dzień kalendarzowy w strefie czasowej trackera, punkty co 10 minut), 7d (dzisiaj i poprzednie 6 dni, punkty godzinowe) lub custom (wymaga parametrów start i end). Domyślnie: today.
start string opcjonalny Pierwszy dzień kalendarzowy wybranego zakresu w formacie YYYY-MM-DD, w strefie czasowej trackera. Wymagany przy range=custom i niedozwolony dla pozostałych zakresów. Nie może przypadać w przyszłości.
end string opcjonalny Ostatni dzień kalendarzowy wybranego zakresu w formacie YYYY-MM-DD, włącznie. Wymagany przy range=custom. Zakres może obejmować maksymalnie 366 dni; data końcowa przypadająca w przyszłości zostaje ograniczona do bieżącego czasu. Rozdzielczość zależy od liczby dni z zarejestrowanymi danymi: do 2 dni — punkty co 10 minut, do 31 dni — punkty godzinowe, dłuższe zakresy — punkty dzienne.

Przykład cURL

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

Przykładowa odpowiedź

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

Pola odpowiedzi

Pole Typ Opis
site string Identyfikator trackera użyty w żądaniu.
range string Żądany zakres czasu.
start string|null Żądany pierwszy dzień dla range=custom; w pozostałych przypadkach null.
end string|null Żądany ostatni dzień dla range=custom; w pozostałych przypadkach null.
timezone string Strefa czasowa trackera używana do wyznaczania dni kalendarzowych i znaczników czasu, na przykład Europe/Zurich.
unit string Zawsze avg_concurrent_readers: średnia liczba czytelników aktywnych jednocześnie w danym punkcie.
resolution_minutes integer Długość każdego punktu w minutach: 2, 10, 60 lub 1440 (jeden dzień kalendarzowy).
from string Początek zakresu jako znacznik czasu ISO 8601 z przesunięciem strefy czasowej trackera. Jeśli żądany zakres zaczyna się przed data_available_from, wartość ta zostaje przesunięta na tę datę.
to string Koniec zakresu jako znacznik czasu ISO 8601 z przesunięciem strefy czasowej. W przypadku trwających zakresów jest to bieżący czas.
data_available_from string Pierwszy dzień z zarejestrowaną historią źródeł: 2026-11-16. Rejestrowanie rozpoczęło się tego dnia około 16:00 UTC, dlatego dane nie obejmują całego dnia.
notice object|null Pole jest ustawione, jeśli zakres sięga przed data_available_from; w pozostałych przypadkach ma wartość null. Żądanie nadal kończy się powodzeniem i zwraca HTTP 200.
notice.code string partial_history: zakres zaczyna się wcześniej, dlatego wartość from została przesunięta, a wcześniejsze dni nie mają punktów. no_history: zakres kończy się przed rozpoczęciem rejestrowania danych, dlatego tablica points jest pusta.
notice.message string Krótki opis w języku angielskim, przeznaczony do logów lub wyświetlenia.
updated_at string Znacznik czasu UTC wskazujący, kiedy obliczono historię.
stale boolean true, jeśli jest to ostatni prawidłowy wynik, ponieważ backend historii jest chwilowo niedostępny.
categories[] array<string> Wszystkie kategorie źródeł w stałej kolejności: organic, discover, direct, internal, social, referral, email, ai. Lista zawsze zawiera wszystkie kategorie, nawet jeśli w danej kategorii nie było czytelników.
points[] array<object> Punkty w kolejności chronologicznej. Pomijane są przedziały czasu bez zebranych danych, dlatego mogą wystąpić luki.
points[].t string Początek punktu jako znacznik czasu ISO 8601 z przesunięciem strefy czasowej. Gdy kończy się czas letni i zegary są cofane, powtórzona godzina jest łączona w jeden punkt.
points[].total number Średnia liczba równoczesnych czytelników ze wszystkich źródeł, zaokrąglona do jednego miejsca po przecinku.
points[].unattributed number Czytelnicy uwzględnieni w total, których nie można przypisać do żadnej kategorii. Obecnie ich liczba wynosi zwykle 0, dlatego wartości kategorii sumują się do total. Udziały należy zawsze obliczać jako wartość kategorii podzieloną przez total, aby wynik pozostał prawidłowy także wtedy, gdy pojawią się nieprzypisani czytelnicy.
points[].values object Średnia liczba równoczesnych czytelników w każdej kategorii, przypisana do nazw z categories. Dla kategorii bez czytelników wartość wynosi 0.

Aktualność danych i buforowanie

Odpowiedzi są buforowane osobno dla każdego trackera i zakresu: przez 60 sekund dla 1h, 24h i today, przez 5 minut dla 7d oraz przez 30 minut dla yesterday. Zakresy niestandardowe są buforowane osobno dla każdej daty początkowej i końcowej: przez 30 minut, jeśli zakres już się zakończył, w przeciwnym razie przez 60 sekund dla punktów co 10 minut albo przez 5 minut dla punktów godzinowych lub dziennych. Jeśli backend historii jest chwilowo niedostępny, zwracany jest ostatni prawidłowy wynik z wartością stale: true i nagłówkiem Warning. Odpowiedź zawiera też nagłówek X-NowMetrix-Microcache z wartością HIT, MISS lub STALE.

Błędy

HTTP Kod Opis
400 site_required Brakuje wymaganego parametru site.
401 missing_token Brakuje nagłówka Authorization.
401 invalid_token Token jest nieprawidłowy lub został unieważniony.
403 site_not_authorized Klucz API nie ma dostępu do tego trackera.
429 rate_limit_exceeded Przekroczono limit żądań.
503 redis_unavailable Backend danych czasu rzeczywistego jest tymczasowo niedostępny.
400 invalid_range Parametr range musi mieć wartość 1h, 24h, today, yesterday, 7d lub custom.
400 invalid_date_range Brakuje parametru start lub end albo data nie ma prawidłowego formatu YYYY-MM-DD; start przypada po end lub w przyszłości; zakres obejmuje więcej niż 366 dni; albo parametry start i end wysłano bez range=custom.
503 source_history_unavailable Historia źródeł jest tymczasowo niedostępna i w buforze nie ma niedawnego wyniku. Żądanie można ponowić po czasie wskazanym w nagłówku Retry-After.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}