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

Recupere os visitantes ativos no seu site nos últimos 5 minutos, com localização e detalhes da sessão, prontos para exibir em um mapa.

Token Bearer (token de workspace ou chave API de website)

Os tokens do espaço de trabalho precisam de um seletor de site

Os tokens da API do Workspace podem acessar todos os sites do workspace. Passe <code>websiteId</code> ou <code>domain</code> para que Flowsery saiba qual site consultar ou alterar. As chaves da API do site já têm como escopo um site, portanto o seletor pode ser omitido.

Seletor de site

ParametroTipoDescricao
websiteIdstringID do site a ser usado com um token de API do workspace. Omitir ao autenticar com uma chave de API de site.
domainstringSite domain para usar com um token de API do espaço de trabalho quando websiteId não for fornecido. Omitir ao autenticar com uma chave de API de site.

Notas

Retorna até 1000 visitantes ativos nos últimos 5 minutos, os mais recentes primeiro. Consulte no máximo uma vez a cada 5 segundos. Campos com valor desconhecido são omitidos do objeto do visitante. name e email só aparecem para visitantes identificados. Filtros de intervalo de datas não são suportados; use /countries ou /cities para geografia em um intervalo de datas.
Exemplo de requisicao (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
    }
  ]
}