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

Haal analytics-data als tijdreeks op, gegroepeerd per uur, dag, week of maand.

Bearer-token (werkruimtetoken of website-API-sleutel)

Werkruimtetokens hebben een websiteselector nodig

Werkruimte-API-tokens hebben toegang tot elke website in de werkruimte. Geef websiteId of domain mee, zodat Flowsery weet welke website je wilt opvragen of wijzigen. Website-API-sleutels horen al bij één website, dus daar kun je de selector weglaten.

Websiteselector

ParameterTypeBeschrijving
websiteIdstringWebsite-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel.
domainstringWebsitedomein om te gebruiken met een werkruimte-API-token als er geen websiteId is opgegeven. Laat weg als je authenticeert met een website-API-sleutel.

Optionele parameters

ParameterTypeBeschrijving
intervalstringAggregatie-interval. Toegestane waarden: hour, day, week, month.
startAtstringStartdatum/-tijd in ISO 8601. Standaard de laatste 30 dagen als je dit weglaat.
endAtstringEinddatum/-tijd in ISO 8601. Standaard nu als je dit weglaat.
timezonestringTijdzone voor de aggregatie (bijv. UTC, America/New_York). Valt terug op de ingestelde tijdzone van de site.
limitnumberWordt teruggegeven in het pagination-object van het antwoord. Het knipt de teruggegeven reeks niet in.
offsetnumberWordt teruggegeven in het pagination-object van het antwoord. Het knipt de teruggegeven reeks niet in.

Filterparameters

ParameterTypeBeschrijving
filter_countrystringLandnaam zoals /countries die teruggeeft, bijv. United States. Gebruik | voor meerdere waarden, ! om uit te sluiten en ~ om op een deel van de waarde te matchen.
filter_regionstringNaam van de regio of staat zoals /regions die teruggeeft, bijv. California.
filter_citystringNaam van de stad.
filter_devicestringApparaattype: Desktop, Mobile of Tablet. Waarden zijn hoofdlettergevoelig.
filter_browserstringBrowsernaam (Chrome, Safari, Firefox, Edge). Safari omvat automatisch ook Mobile Safari.
filter_osstringBesturingssysteem (Mac OS, Windows, iOS, Android).
filter_referrerstringReferrer zoals /referrers die teruggeeft: een bronnaam zoals Google voor herkende sites, anders het domein.
filter_refstringDe waarde van de URL-parameter ref.
filter_sourcestringDe waarde van de URL-parameter source.
filter_viastringDe waarde van de URL-parameter via.
filter_utm_sourcestringUTM-bron.
filter_utm_mediumstringUTM-medium.
filter_utm_campaignstringUTM-campagne.
filter_utm_termstringUTM-term.
filter_utm_contentstringUTM-content.
filter_pagestringPaginapad of URL.
filter_entry_pagestringPad of URL van de instappagina.
filter_hostnamestringHostnaam/domein.
filter_channelstringMarketingkanaal.
filter_goalstringGoalnaam.

Opmerkingen

De API geeft status, interval, tijdzone, valuta, datarijen, totalen en een pagination-echo terug. Datarijen bevatten timestamp, name, visitors, sessions, revenue, newRevenue, renewalRevenue, refundedRevenue, conversionRate en kpiValue. Welk interval je ook kiest, het venster is standaard de laatste 30 dagen. Geef dus startAt en endAt mee voor iets anders en beperk hour tot een paar dagen.
Voorbeeldverzoek (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 }
}