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