Visitors per place
Per country, region or city, with coordinates for a map.
An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.
In: header
Path Parameters
The project id, as listed by GET /v2/projects.
1 <= lengthQuery Parameters
Start of the range; send with to.
date-timeEnd of the range, exclusive.
date-timeA 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"
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"
production (the default) leaves preview deployments out, preview keeps only them, all keeps both.
Value in
- "production"
- "preview"
- "all"
Sent as filter[<dimension>]=value, or !value to exclude; repeatable across dimensions.
What a place is: country (the default), region or city.
Value in
- "country"
- "region"
- "city"
Rows per page, 1 to 100 (default 20), or up to 1000 with format.
1 <= value <= 1000The opaque nextCursor of the previous page.
1 <= lengthReturns 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/projects/string/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": {}}