api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/realtime/mapObtener los visitantes activos en su sitio en los últimos 5 minutos, con su ubicación y los detalles de su sesión, listos para mostrar en un mapa.
Token Bearer (token de workspace o clave API de sitio web)
Los tokens de espacio de trabajo necesitan un selector de sitio web
Los tokens de API del espacio de trabajo pueden acceder a todos los sitios web del espacio de trabajo. Pase <code>websiteId</code> o <code>domain</code> para que Flowsery sepa qué sitio web consultar o mutar. Las claves API del sitio web ya están destinadas a un sitio web, por lo que se puede omitir el selector.Selector de sitios web
| Parametro | Tipo | Descripcion |
|---|---|---|
websiteId | string | ID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web. |
domain | string | Sitio web domain para usar con un token API de espacio de trabajo cuando no se proporciona websiteId. Omitir al autenticarse con una clave API de sitio web. |
Notas
Devuelve hasta 1000 visitantes activos en los últimos 5 minutos, los más recientes primero. Consulte como máximo una vez cada 5 segundos. Los campos cuyo valor se desconoce se omiten del objeto de visitante. name y email solo aparecen para visitantes identificados. No se admiten filtros de rango de fechas; use /countries o /cities para geografía en un rango de fechas.Solicitud de ejemplo (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
}
]
}