api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/timeseriesPobiera dane analityczne w szeregu czasowym, pogrupowane według godziny, dnia, tygodnia lub miesiąca.
Bearer Token (token obszaru roboczego lub klucz API witryny)
Tokeny obszaru roboczego wymagają wskazania witryny
Tokeny API obszaru roboczego mają dostęp do wszystkich witryn w obszarze. Należy przekazaćwebsiteId lub domain, aby Flowsery wiedziało, której witryny dotyczy zapytanie lub zmiana. Klucze API witryn są już przypisane do jednej witryny, więc można to pominąć.Wskazanie witryny
| Parametr | Typ | Opis |
|---|---|---|
websiteId | string | ID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
domain | string | Domena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny. |
Parametry opcjonalne
| Parametr | Typ | Opis |
|---|---|---|
interval | string | Interwał agregacji. Dozwolone wartości: hour, day, week, month. |
startAt | string | Data i godzina początku w ISO 8601. Po pominięciu: ostatnie 30 dni. |
endAt | string | Data i godzina końca w ISO 8601. Po pominięciu: teraz. |
timezone | string | Strefa czasowa agregacji (np. UTC, America/New_York). Domyślnie strefa skonfigurowana dla witryny. |
limit | number | Zwracany w obiekcie paginacji odpowiedzi. Nie przycina zwracanej serii. |
offset | number | Zwracany w obiekcie paginacji odpowiedzi. Nie przycina zwracanej serii. |
Parametry filtrowania
| Parametr | Typ | Opis |
|---|---|---|
filter_country | string | Nazwa kraju zwracana przez /countries, np. United States. | rozdziela kilka wartości, ! wyklucza, a ~ dopasowuje fragment wartości. |
filter_region | string | Nazwa regionu lub stanu zwracana przez /regions, np. California. |
filter_city | string | Nazwa miasta. |
filter_device | string | Typ urządzenia: Desktop, Mobile lub Tablet. Wielkość liter ma znaczenie. |
filter_browser | string | Nazwa przeglądarki (Chrome, Safari, Firefox, Edge). Safari automatycznie obejmuje Mobile Safari. |
filter_os | string | System operacyjny (Mac OS, Windows, iOS, Android). |
filter_referrer | string | Źródło odesłania zwracane przez /referrers: nazwa źródła, np. Google, dla rozpoznanych witryn, a w pozostałych przypadkach domena. |
filter_ref | string | Wartość parametru URL ref. |
filter_source | string | Wartość parametru URL source. |
filter_via | string | Wartość parametru URL via. |
filter_utm_source | string | Źródło UTM. |
filter_utm_medium | string | Medium UTM. |
filter_utm_campaign | string | Kampania UTM. |
filter_utm_term | string | Termin UTM. |
filter_utm_content | string | Treść UTM. |
filter_page | string | Ścieżka lub adres URL strony. |
filter_entry_page | string | Ścieżka lub adres URL strony wejścia. |
filter_hostname | string | Host/domena. |
filter_channel | string | Kanał marketingowy. |
filter_goal | string | Nazwa celu. |
Uwagi
API zwraca status, interval, timezone, currency, wiersze danych, sumy i kopię paginacji. Wiersze danych zawierają timestamp, name, visitors, sessions, revenue, newRevenue, renewalRevenue, refundedRevenue, conversionRate i kpiValue. Niezależnie od interwału domyślny zakres to ostatnie 30 dni, więc dla innych okresów należy podać startAt i endAt, a hour stosować do zakresów kilkudniowych.Przykładowe żądanie (Curl)
curl --request GET \
--url 'https://analytics.flowsery.com/analytics/api/v1/timeseries?interval=day&limit=30' \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"interval": "day",
"timezone": "Asia/Calcutta",
"currency": "USD",
"data": [
{
"timestamp": "2025-12-17T00:00:00+05:30",
"name": "17 Dec",
"visitors": 528,
"sessions": 604,
"revenue": 1540,
"newRevenue": 1220,
"renewalRevenue": 320,
"refundedRevenue": 40,
"conversionRate": 1.42,
"kpiValue": 1540
}
],
"totals": {
"visitors": 14213,
"sessions": 20181,
"revenue": 27351
},
"pagination": { "limit": 30, "offset": 0, "total": 30 }
}