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

Haal analytics-data op, uitgesplitst per browser.

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.

Queryparameters

ParameterTypeBeschrijving
startAtstringStartdatum/-tijd in ISO 8601 (bijv. 2024-01-01T00:00:00Z). 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.
limitnumberMaximaal aantal rijen om terug te geven (1-1000, standaard: 100).
offsetnumberAantal rijen om over te slaan voor paginering (min. 0, standaard: 0).

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. 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.

Velden in het antwoord

Elk item in de array data bevat de browsernaam, het aantal bezoekers en de omzet die aan die browser is toegewezen.

Filters combineren

Scheid meerdere waarden binnen één filterparameter met |. Combineer verschillende filterparameters om de resultaten verder te verfijnen (bijv. filter_browser=Chrome|Safari&filter_device=Mobile).
Voorbeeldverzoek (curl)
curl --request GET \
  --url 'https://analytics.flowsery.com/analytics/api/v1/browsers' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "value": "Chrome",
      "visitors": 8920,
      "revenue": 18450,
      "newRevenue": 14330,
      "renewalRevenue": 4120,
      "percentage": 65.2
    },
    {
      "value": "Safari",
      "visitors": 3450,
      "revenue": 2890,
      "newRevenue": 2050,
      "renewalRevenue": 840,
      "percentage": 25.2
    },
    {
      "value": "Firefox",
      "visitors": 380,
      "revenue": 0,
      "newRevenue": 0,
      "renewalRevenue": 0,
      "percentage": 2.8
    },
    {
      "value": "Edge",
      "visitors": 320,
      "revenue": 1450,
      "newRevenue": 1270,
      "renewalRevenue": 180,
      "percentage": 2.3
    },
    {
      "value": "Samsung Internet",
      "visitors": 290,
      "revenue": 980,
      "newRevenue": 840,
      "renewalRevenue": 140,
      "percentage": 2.1
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 28
  }
}