Locations
Get geographic breakdown of visitors for a site.
Locations
Returns a breakdown of visitors by country, ranked by unique visitor count.
Endpoint
GET /api/v1/organizations/:orgId/sites/:siteId/analytics/locations
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
period | string | No | Time period (day, 7d, 30d, month, 12mo, custom) |
type | string | No | Breakdown type: country, region, or city (default: country) |
limit | number | No | Maximum number of results (default: 10) |
filters | string | No | JSON-encoded filter array |
Response fields
Returns an array of location entries:
| Field | Type | Description |
|---|---|---|
location | string | Location name (country code, region, or city) |
visitors | number | Unique visitors from this location |