Spoar
Reads

Headline numbers

GET
/v2/projects/{project}/stats

Visitors, sessions, pageviews, pages per session, bounce rate and session duration, each with the previous period.

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

from?string

Start of the range; send with to.

Formatdate-time
to?string

End of the range, exclusive.

Formatdate-time
period?string

A range ending at the start of today in UTC (24h ends at the start of this hour). Ignored when from and to are sent; 30d by default.

Value in

  • "24h"
  • "7d"
  • "30d"
  • "90d"
  • "12mo"
  • "all"
traffic?string

Which traffic is counted. human (the default) leaves out bot scores of 50 and up, your own visits and localhost; bots keeps only scores of 50 and up; internal keeps only your own visits; all keeps everything.

Value in

  • "human"
  • "bots"
  • "internal"
  • "all"
environment?string

production (the default) leaves preview deployments out, preview keeps only them, all keeps both.

Value in

  • "production"
  • "preview"
  • "all"
filter?

Sent as filter[<dimension>]=value, or !value to exclude; repeatable across dimensions.

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/stats"
{  "data": {    "visitors": {      "value": 1204,      "previous": 1011,      "change": 0.191    },    "sessions": {      "value": 1530,      "previous": 1290,      "change": 0.186    },    "pageviews": {      "value": 3822,      "previous": 3105,      "change": 0.231    },    "pagesPerSession": {      "value": 2.5,      "previous": 2.41,      "change": 0.037    },    "bounceRate": {      "value": 0.46,      "previous": 0.49,      "change": -0.061    },    "sessionDurationMs": {      "value": 71000,      "previous": 64000,      "change": 0.109    }  },  "range": {    "from": "2026-09-20T00:00:00.000Z",    "to": "2026-09-27T00:00:00.000Z"  },  "previousRange": {    "from": "2026-09-13T00:00:00.000Z",    "to": "2026-09-20T00:00:00.000Z"  },  "traffic": "human",  "environment": "production",  "filters": {}}