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

Pobiera dane analityczne według własnych celów. Parametry filtrowania zawężają, których odwiedzających realizacje są liczone; limit i offset służą do stronicowania listy celów.

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
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.
limitnumberMaksymalna liczba zwracanych wierszy (1-1000, domyślnie: 100).
offsetnumberLiczba wierszy do pominięcia przy paginacji (min. 0, domyślnie: 0).

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. Safari automatycznie obejmuje Mobile Safari.
filter_osstringSystem operacyjny.
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_refstringParametr URL ref.
filter_sourcestringParametr URL source.
filter_viastringParametr 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 strony.
filter_entry_pagestringŚcieżka strony wejścia.
filter_hostnamestringHost/domena.
filter_channelstringKanał marketingowy.
filter_goalstringNazwa celu.
Przykładowe żądanie (Curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/goals \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "id": "goal_123",
      "createdAt": "2026-04-01T10:15:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "newsletter_signup",
      "description": null,
      "isServer": false,
      "completions": 49730,
      "visitors": 49730
    },
    {
      "id": "goal_124",
      "createdAt": "2026-04-02T09:00:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "payment",
      "description": "Tracked from the backend",
      "isServer": true,
      "completions": 35100,
      "visitors": 35100
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 48
  }
}