api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/realtime/mapHaal de bezoekers op die in de laatste 5 minuten actief waren op je site, met hun locatie en sessiegegevens, klaar om op een kaart te tonen.
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. |
Opmerkingen
Geeft tot 1000 bezoekers terug die in de afgelopen 5 minuten actief waren, de meest recente eerst. Poll hoogstens één keer per 5 seconden. Velden met een onbekende waarde ontbreken in het bezoekersobject. name en email komen uit geregistreerde betalingen, dus ze verschijnen alleen bij bezoekers die betaald hebben; behandel ze als persoonsgegevens. Filters op datumbereik worden niet ondersteund; gebruik /countries of /cities voor geografie over een datumbereik.Voorbeeldverzoek (curl)
curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/realtime/map \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": [
{
"visitorId": "vis_9f2c1a7e",
"visitorUid": "user_4821",
"country": "United States",
"countryCode": "US",
"region": "California",
"city": "San Francisco",
"latitude": 37.7749,
"longitude": -122.4194,
"browser": "Chrome",
"os": "Mac OS",
"deviceType": "Desktop",
"currentUrl": "https://example.com/pricing",
"referrer": "https://www.google.com/",
"referrerSource": "Google",
"referrerIconUrl": "https://icons.duckduckgo.com/ip3/google.com.ico",
"sessionStartTime": "2026-04-14T08:27:12.000Z",
"pageviews": 4,
"totalRevenue": 129,
"isCustomer": true,
"name": "Jane Doe",
"email": "jane@example.com"
},
{
"visitorId": "vis_b81d40c3",
"country": "Germany",
"countryCode": "DE",
"city": "Berlin",
"latitude": 52.52,
"longitude": 13.405,
"browser": "Safari",
"os": "iOS",
"deviceType": "Mobile",
"currentUrl": "https://example.com/",
"sessionStartTime": "2026-04-14T08:29:45.000Z",
"pageviews": 1,
"totalRevenue": 0,
"isCustomer": false
}
]
}