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

Die in den letzten 5 Minuten aktiven Besucher Ihrer Website mit Standort- und Sitzungsdetails abrufen, bereit zur Darstellung auf einer Karte.

Bearer-Token (Workspace-Token oder Website-API-Schlüssel)

Workspace-Tokens benötigen einen Website-Selektor

Workspace-API-Tokens können auf jede Website im Workspace zugreifen. Übergeben Sie entweder <code>websiteId</code> oder <code>domain</code>, damit Flowsery weiß, welche Website abgefragt oder geändert werden muss. Website-API-Schlüssel sind bereits auf eine Website beschränkt, sodass der Selektor weggelassen werden kann.

Website-Auswahl

ParameterTypBeschreibung
websiteIdstringWebsite-ID zur Verwendung mit einem Workspace-API-Token. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.
domainstringWebsite domain zur Verwendung mit einem Workspace-API-Token, wenn websiteId nicht bereitgestellt wird. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.

Hinweise

Gibt bis zu 1000 Besucher zurück, die in den letzten 5 Minuten aktiv waren, neueste zuerst. Fragen Sie höchstens alle 5 Sekunden ab. Felder mit unbekanntem Wert werden im Besucherobjekt weggelassen. name und email sind nur bei identifizierten Besuchern vorhanden. Datumsbereichsfilter werden nicht unterstützt; verwenden Sie /countries oder /cities für geografische Daten über einen Zeitraum.
Beispielanfrage (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
    }
  ]
}