Best analytics tool I've used in 14 years

Get realtime map data

GET https://datafa.st/api/v1/analytics/realtime/map

Retrieve active visitors (last 10 minutes), recent events, and recent payments for the realtime map. Requires Bearer Token authentication.

Response

Success (200 OK): Returns realtime map data

{
  "status": "success",
  "data": {
    "count": 2,
    "visitors": [
      {
        "visitorId": "b971cbbf-7ce2-4925-902b-8f95a5fb3449",
        "location": {
          "city": "Denver",
          "region": "US-CO",
          "countryCode": "US"
        },
        "system": {
          "browser": { "name": "Chrome" },
          "os": { "name": "Mac OS" },
          "device": { "type": "desktop" }
        },
        "currentUrl": "/pricing",
        "referrer": null,
        "sessionStartTime": "2026-02-06T05:27:20.000Z",
        "visitCount": 1,
        "params": {
          "ref": null,
          "source": null,
          "via": null,
          "utm_source": null,
          "utm_medium": null,
          "utm_campaign": null,
          "utm_content": null,
          "utm_term": null
        },
        "latitude": 39.7391,
        "longitude": -104.9866,
        "isCustomer": false,
        "customerName": null,
        "customerEmail": null,
        "profileData": {
          "displayName": null,
          "userId": null,
          "hasProfile": false,
          "isRandomName": true
        },
        "conversionLikelihood": {
          "score": 65,
          "confidence": 0.763,
          "isBaseline": false,
          "dimensionMatches": ["device", "os", "browser", "country", "referrer"],
          "raw": {
            "conversionRate": 0.0056,
            "averageValue": 246.98,
            "expectedValue": 1.37
          }
        }
      }
    ],
    "conversionMetrics": {
      "baselineConversionRate": 0.0044,
      "baselineAverageValue": 243.63
    },
    "hasConversionPredictions": true,
    "recentEvents": [
      {
        "_id": "69857bb827ddefd472fb2b09",
        "type": "pageview",
        "visitorId": "b971cbbf-7ce2-4925-902b-8f95a5fb3449",
        "timestamp": "2026-02-06T05:27:20.000Z",
        "path": "/pricing",
        "countryCode": "US",
        "extraData": {},
        "referrer": null,
        "customerName": null,
        "amount": null,
        "displayName": null
      }
    ],
    "recentPayments": [
      {
        "_id": "69857bb827ddefd472fb2b12",
        "type": "payment_received",
        "timestamp": "2026-02-06T05:26:10.000Z",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "amount": 49,
        "currency": "USD",
        "renewal": false,
        "displayName": null,
        "isNew": false,
        "visible": true
      }
    ]
  }
}

Notes

  • Time window is the last 10 minutes for active visitors, recent events, and recent payments.
  • conversionLikelihood and conversionMetrics are included only when conversion modeling data is available.
  • hasConversionPredictions will be false when no conversion metrics exist yet.

Errors

  • 401 Unauthorized: Missing or invalid API key
  • 404 Not Found: Website not found
  • 500 Internal Server Error: Server-side issue
Something missing? Suggest features ✍️