api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/goalsHaal analytics-data op, uitgesplitst per aangepaste goal. Filterparameters bepalen van welke bezoekers de voltooiingen meetellen; met limit en offset blader je door de lijst met goals.
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 |
|---|---|---|
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 je site. |
limit | number | Maximaal aantal rijen om terug te geven (1-1000, standaard: 100). |
offset | number | Aantal rijen om over te slaan voor paginering (min. 0, standaard: 0). |
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. Safari omvat automatisch ook Mobile Safari. |
filter_os | string | Besturingssysteem. |
filter_referrer | string | Referrer zoals /referrers die teruggeeft: een bronnaam zoals Google voor herkende sites, anders het domein. |
filter_ref | string | De URL-parameter ref. |
filter_source | string | De URL-parameter source. |
filter_via | string | 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. |
filter_entry_page | string | Pad van de instappagina. |
filter_hostname | string | Hostnaam/domein. |
filter_channel | string | Marketingkanaal. |
filter_goal | string | Goalnaam. |
Voorbeeldverzoek (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
}
}