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

Fetch the visitors active on your site in the last 5 minutes, with their location and session details, ready to plot on a map.

Bearer Token (workspace token or website API key)

Workspace Tokens Need a Website Selector

Workspace API tokens can access every website in the workspace. Pass either <code>websiteId</code> or <code>domain</code> so Flowsery knows which website to query or mutate. Website API keys are already scoped to one website, so the selector can be omitted.

Website Selector

ParameterTypeDescription
websiteIdstringWebsite ID to use with a workspace API token. Omit when authenticating with a website API key.
domainstringWebsite domain to use with a workspace API token when websiteId is not provided. Omit when authenticating with a website API key.

Notes

Returns up to 1000 visitors active within the past 5 minutes, most recent first. Poll at most once every 5 seconds. Fields whose value is unknown are omitted from the visitor object. name and email are only present for identified visitors. Date range filters are not supported; use /countries or /cities for geography over a date range.
Example Request (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.flowsery.com/google.com",
      "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
    }
  ]
}