api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/timeseries

Pobiera 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

ParametrTypOpis
websiteIdstringID witryny używane z tokenem API obszaru roboczego. Należy pominąć przy uwierzytelnianiu kluczem API witryny.
domainstringDomena witryny używana z tokenem API obszaru roboczego, gdy nie podano websiteId. Należy pominąć przy uwierzytelnianiu kluczem API witryny.

Parametry opcjonalne

ParametrTypOpis
intervalstringInterwał agregacji. Dozwolone wartości: hour, day, week, month.
startAtstringData i godzina początku w ISO 8601. Po pominięciu: ostatnie 30 dni.
endAtstringData i godzina końca w ISO 8601. Po pominięciu: teraz.
timezonestringStrefa czasowa agregacji (np. UTC, America/New_York). Domyślnie strefa skonfigurowana dla witryny.
limitnumberZwracany w obiekcie paginacji odpowiedzi. Nie przycina zwracanej serii.
offsetnumberZwracany w obiekcie paginacji odpowiedzi. Nie przycina zwracanej serii.

Parametry filtrowania

ParametrTypOpis
filter_countrystringNazwa kraju zwracana przez /countries, np. United States. | rozdziela kilka wartości, ! wyklucza, a ~ dopasowuje fragment wartości.
filter_regionstringNazwa regionu lub stanu zwracana przez /regions, np. California.
filter_citystringNazwa miasta.
filter_devicestringTyp urządzenia: Desktop, Mobile lub Tablet. Wielkość liter ma znaczenie.
filter_browserstringNazwa przeglądarki (Chrome, Safari, Firefox, Edge). Safari automatycznie obejmuje Mobile Safari.
filter_osstringSystem operacyjny (Mac OS, Windows, iOS, Android).
filter_referrerstringŹródło odesłania zwracane przez /referrers: nazwa źródła, np. Google, dla rozpoznanych witryn, a w pozostałych przypadkach domena.
filter_refstringWartość parametru URL ref.
filter_sourcestringWartość parametru URL source.
filter_viastringWartość parametru URL via.
filter_utm_sourcestringŹródło UTM.
filter_utm_mediumstringMedium UTM.
filter_utm_campaignstringKampania UTM.
filter_utm_termstringTermin UTM.
filter_utm_contentstringTreść UTM.
filter_pagestringŚcieżka lub adres URL strony.
filter_entry_pagestringŚcieżka lub adres URL strony wejścia.
filter_hostnamestringHost/domena.
filter_channelstringKanał marketingowy.
filter_goalstringNazwa 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 }
}