api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/timeseriesHaal 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. GeefwebsiteId 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
| Parameter | Type | Beschrijving |
|---|---|---|
websiteId | string | Website-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel. |
domain | string | Websitedomein 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
| Parameter | Type | Beschrijving |
|---|---|---|
interval | string | Aggregatie-interval. Toegestane waarden: hour, day, week, month. |
startAt | string | Startdatum/-tijd in ISO 8601. Standaard de laatste 30 dagen als je dit weglaat. |
endAt | string | Einddatum/-tijd in ISO 8601. Standaard nu als je dit weglaat. |
timezone | string | Tijdzone voor de aggregatie (bijv. UTC, America/New_York). Valt terug op de ingestelde tijdzone van de site. |
limit | number | Wordt teruggegeven in het pagination-object van het antwoord. Het knipt de teruggegeven reeks niet in. |
offset | number | Wordt teruggegeven in het pagination-object van het antwoord. Het knipt de teruggegeven reeks niet in. |
Filterparameters
| Parameter | Type | Beschrijving |
|---|---|---|
filter_country | string | Landnaam 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_region | string | Naam van de regio of staat zoals /regions die teruggeeft, bijv. California. |
filter_city | string | Naam van de stad. |
filter_device | string | Apparaattype: Desktop, Mobile of Tablet. Waarden zijn hoofdlettergevoelig. |
filter_browser | string | Browsernaam (Chrome, Safari, Firefox, Edge). Safari omvat automatisch ook Mobile Safari. |
filter_os | string | Besturingssysteem (Mac OS, Windows, iOS, Android). |
filter_referrer | string | Referrer zoals /referrers die teruggeeft: een bronnaam zoals Google voor herkende sites, anders het domein. |
filter_ref | string | De waarde van de URL-parameter ref. |
filter_source | string | De waarde van de URL-parameter source. |
filter_via | string | De waarde van de URL-parameter via. |
filter_utm_source | string | UTM-bron. |
filter_utm_medium | string | UTM-medium. |
filter_utm_campaign | string | UTM-campagne. |
filter_utm_term | string | UTM-term. |
filter_utm_content | string | UTM-content. |
filter_page | string | Paginapad of URL. |
filter_entry_page | string | Pad of URL van de instappagina. |
filter_hostname | string | Hostnaam/domein. |
filter_channel | string | Marketingkanaal. |
filter_goal | string | Goalnaam. |
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 }
}