Spoar
All projects

Visitors per place across projects

GET
/v2/map

As the per-project route.

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

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.

level?string

What a place is: country (the default), region or city.

Value in

  • "country"
  • "region"
  • "city"
limit?|

Rows per page, 1 to 100 (default 20), or up to 1000 with format.

Range1 <= value <= 1000
cursor?string

The opaque nextCursor of the previous page.

Length1 <= length
format?string

Returns every row as one download instead of a page, up to 1,000,000 rows: csv with a header row and nested fields as dotted columns, json as the normal answer with all rows in data, sql as CREATE TABLE and INSERT statements for Postgres or SQLite. Accept: text/csv also asks for CSV.

Value in

  • "csv"
  • "json"
  • "sql"

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/map"
{  "data": [    {      "country": "NL",      "region": "Noord-Holland",      "city": "Amsterdam",      "latitude": 52.37,      "longitude": 4.9,      "visitors": 64,      "share": 0.213    },    {      "country": "US",      "region": "California",      "city": "San Francisco",      "latitude": 37.77,      "longitude": -122.42,      "visitors": 31,      "share": 0.103    }  ],  "level": "city",  "total": 142,  "nextCursor": "eyJvIjoyfQ",  "range": {    "from": "2026-08-31T00:00:00.000Z",    "to": "2026-09-28T00:00:00.000Z"  },  "traffic": "human",  "environment": "production",  "filters": {}}

Weekday and hour heatmap across projects GET

Previous Page

Live events across projects GET

Next Page