api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/devicesHaal analytics-data op, uitgesplitst per apparaattype.
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/devices?limit=10' \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": [
{
"value": "Desktop",
"visitors": 7892,
"revenue": 18234,
"newRevenue": 14114,
"renewalRevenue": 4120,
"percentage": 55.3
},
{
"value": "Mobile",
"visitors": 6124,
"revenue": 8934,
"newRevenue": 6554,
"renewalRevenue": 2380,
"percentage": 42.9
},
{
"value": "Tablet",
"visitors": 234,
"revenue": 567,
"newRevenue": 567,
"renewalRevenue": 0,
"percentage": 1.6
}
],
"pagination": {
"limit": 100,
"offset": 0,
"total": 3
}
}