Audience geography report
Returns audience geography metrics grouped by country, region, or city. Requires the `analytics:read` scope.
Returns audience geography metrics grouped by country, region, or city. Requires the analytics:read scope.
Authorization
BearerAuth AuthorizationBearer <token>
Pass the raw API key as a Bearer token (Authorization: Bearer <key>). Publishable keys start with mvi_pub_ (playback-scoped). Other prefixes denote private/admin keys for general REST routes. GET /v1/embeds/{embedId}/playback accepts publishable keys only.
In: header
Query Parameters
startDate*string
Start of date range (ISO 8601 date).
endDate*string
End of date range (ISO 8601 date).
level?string
Aggregation level. Defaults to country.
Value in
"country" | "region" | "city"country?string
Optional country filter for region or city reports.
countryRegion?string
Optional region filter for city reports.
Response Body
application/json
application/json
curl -X GET "https://api.moviie.ai/v1/analytics/geography?startDate=2024-01-01&endDate=2024-01-31"{
"level": "country",
"filters": {
"country": "string",
"countryRegion": "string"
},
"dateRange": {
"start": "2019-08-24T14:15:22Z",
"end": "2019-08-24T14:15:22Z"
},
"items": [
{
"id": "string",
"level": "country",
"label": "string",
"country": "string",
"countryRegion": "string",
"city": "string",
"latitude": 0,
"longitude": 0,
"timezone": "string",
"views": 0,
"plays": 0,
"uniqueViews": 0,
"uniquePlays": 0,
"watchTimeSeconds": 0,
"ctaClicks": 0
}
]
}{
"error": "Resource not found",
"code": "NOT_FOUND"
}