api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/realtime/map

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

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
    }
  ]
}