API Reference

Get video city data

Retrieves analytics data grouped by cities for a specific video

GET /city/{video_id}

Retrieves analytics data grouped by cities for a specific video.

Detailed Description

Retrieves detailed analytics data grouped by cities for a specific video, showing viewer distribution and engagement metrics at the city level. This endpoint provides geographic insights including latitude and longitude coordinates for mapping and visualization purposes for a single video.

HTTP Method & Path

GET /city/{video_id}

Authentication Requirements

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

Parameters

NameInTypeRequiredDescription
AuthorizationheaderstringYesPanda API token (without Bearer prefix)
video_idpathstring (uuid)YesUnique identifier of the video
start_datequerystring (date)NoStart date for analytics data. Format: YYYY-MM-DD (e.g., 2025-01-01)
end_datequerystring (date)NoEnd date for analytics data. Format: YYYY-MM-DD (e.g., 2025-01-01)
granularityquerystringNoData granularity (total, day, hour). Default: total
countryquerystringNoFilter by country (e.g., BR, US, CA)
regionquerystringNoFilter by region (required when granularity=day or hour)
cityquerystringNoFilter by city name
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!