Spoar
Dev widget

Active visitors

GET
/v2/projects/{project}/realtime/visitors

One row per visitor seen in the last five minutes, newest activity first: their session, latest pageview, referrer, place, device, pages and duration this session, bot score, and whether they are identified (never the user id). limit from 1 to 200, default 50.

Authorization

AuthorizationBearer <token>

An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.

In: header

Path Parameters

project*string

The project id, as listed by GET /v2/projects.

Length1 <= length

Query Parameters

limit?string

Rows to return, from 1 to 200; 50 by default.

Match^[0-9]+$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/projects/string/realtime/visitors"
{  "data": [    {      "visitor": "8c4e1f0a-2b3c-4d5e-8f60-718293a4b5c6",      "session": "f1a2b3c4",      "lastSeen": "2026-10-03T14:02:04.117Z",      "path": "/pricing",      "referrer": "https://www.google.com/",      "country": "NL",      "city": "Leeuwarden",      "device": "mobile",      "browser": "Safari",      "os": "iOS",      "pages": 4,      "duration": 132,      "botScore": 0,      "identified": false    }  ],  "window": {    "from": "2026-10-03T13:57:04.117Z",    "to": "2026-10-03T14:02:04.117Z"  }}