GET /region

Retrieves analytics data grouped by geographic regions across all videos.

Detailed Description

Retrieves comprehensive analytics data grouped by geographic regions, showing viewer distribution and engagement metrics across different countries and regions. This endpoint provides insights into global audience reach and regional performance patterns.

HTTP Method & Path

GET /region

Authentication Requirements

Security Scheme: PandaAuth (apiKey)
Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Name	In	Type	Required	Description
Authorization	header	string	Yes	Panda API token (without Bearer prefix)
start_date	query	string (date)	No	Start date for analytics data. Format: YYYY-MM-DD (e.g., 2025-01-01)
end_date	query	string (date)	No	End date for analytics data. Format: YYYY-MM-DD (e.g., 2025-01-01)
granularity	query	string	No	Data granularity (total, day, hour). Default: total
country	query	string	No	Filter by country (e.g., BR, US, CA)
region	query	string	No	Filter by region (required when granularity=day or hour)

Notes

Country codes follow ISO 3166-1 alpha-2 standard (e.g., BR, US, CA)
When using granularity=day or granularity=hour, both region and country parameters are required

200Regional analytics data retrieved successfully

400Bad request - Invalid input parameters

401Unauthorized - Invalid or missing authentication

404Not found - Resource does not exist

500Internal server error