Panda Video Geographic Analytics API
Operations for geographic analytics (city/region)
Operations for geographic analytics (city/region)
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/pandavideo-com:pandavideo-com-geographic-analytics-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Panda Analytics Geographic Analytics API
description: 'API for analytics data in the Panda platform.
This API allows you to:
- Retrieve real-time analytics data
- Access general analytics metrics
- Get retention analytics
- View ranking data
- Analyze geographic data (city/region)
- Access live streaming analytics
- Get billing and usage data
- Filter analytics by type'
version: 1.0.0
contact:
name: Panda Team
email: support@panda.video
servers:
- url: https://data.pandavideo.com
description: Production server
- url: http://localhost:8001
description: Local development server
tags:
- name: Geographic Analytics
description: Operations for geographic analytics (city/region)
paths:
/city:
get:
summary: Get city analytics for account
description: Retrieves city-based analytics data for the authenticated user's account
tags:
- Geographic Analytics
security:
- PandaAuth: []
parameters:
- name: start_date
in: query
description: Start date for analytics period
schema:
type: string
format: date
- name: end_date
in: query
description: End date for analytics period
schema:
type: string
format: date
responses:
'200':
description: City analytics data retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/CityAnalytics'
operationId: getCity
x-operation-id-source: derived
/city/{videoId}:
get:
summary: Get city analytics for specific video
description: 'Retrieves metrics for a specific video per country, region and city. With `granularity=hour` or `day` the keys follow `timezone`.
**Time window and time zone**
- `start_date` and `end_date` accept `YYYY-MM-DD` or `YYYY-MM-DDTHH:00` (minutes must be `00`).
- The window is `[start, end)`. A date without an hour covers the whole day: `start_date=2026-10-20&end_date=2026-10-20` returns all of October 20.
- `timezone` (IANA, e.g. `America/Sao_Paulo`) defines how the dates are read and how days and hours are labeled in the response. Without `timezone` and without hours in the dates, days and hours are in UTC (same response as before).
- Unique metrics over a window are the sum of the unique metrics of each hour: a viewer who comes back in different hours is counted once per hour.
- Returns `400` for an invalid time zone, a time zone with a non whole-hour UTC offset (e.g. `Asia/Kolkata`), minutes other than `00`, or `end_date` not after `start_date`.
**Most recent data**: includes the current day.'
tags:
- Geographic Analytics
security:
- PandaAuth: []
parameters:
- name: videoId
in: path
required: true
description: Unique identifier of the video
schema:
type: string
- name: start_date
in: query
required: false
description: 'Start of the window: `YYYY-MM-DD` (start of the day) or `YYYY-MM-DDTHH:00`, in `timezone`.'
schema:
type: string
pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
example: '2026-10-20'
- name: end_date
in: query
required: false
description: 'End of the window, exclusive: `YYYY-MM-DDTHH:00` stops right before that hour; `YYYY-MM-DD` includes the whole day. Read in `timezone`.'
schema:
type: string
pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
example: '2026-10-21'
- name: timezone
in: query
required: false
description: IANA time zone used to read `start_date`/`end_date` and to label days and hours in the response (e.g. `America/Sao_Paulo`, `America/New_York`, `UTC`). When omitted and the dates have no hour, everything is in UTC.
schema:
type: string
example: America/Sao_Paulo
- name: granularity
in: query
required: false
description: '`total` (default), `day` or `hour`. `day` and `hour` require the location filters.'
schema:
type: string
enum:
- total
- day
- hour
default: total
- name: country
in: query
required: false
description: Country code, e.g. `BR`. Required for `day`/`hour`.
schema:
type: string
- name: region
in: query
required: false
description: Region name, e.g. `São Paulo`. Required for `day`/`hour`.
schema:
type: string
- name: city
in: query
required: false
description: City name. Required for `day`/`hour`.
schema:
type: string
responses:
'200':
description: Video city analytics data retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/VideoCityAnalytics'
examples:
OK:
summary: OK
value:
BR:
Rio de Janeiro:
Niterói:
lat: -22.8896
lng: -43.1054
total:
view: 40
play: 26
unique_play: 3
unique_view: 4
'400':
$ref: '#/components/responses/BadRequestError'
operationId: getCityByVideoId
x-operation-id-source: derived
/region:
get:
summary: Get region analytics for account
description: Retrieves region-based analytics data for the authenticated user's account
tags:
- Geographic Analytics
security:
- PandaAuth: []
parameters:
- name: start_date
in: query
description: Start date for analytics period
schema:
type: string
format: date
- name: end_date
in: query
description: End date for analytics period
schema:
type: string
format: date
responses:
'200':
description: Region analytics data retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/RegionAnalytics'
operationId: getRegion
x-operation-id-source: derived
/region/{videoId}:
get:
summary: Get region analytics for specific video
description: 'Retrieves metrics for a specific video per country and region. With `granularity=hour` or `day` the keys follow `timezone`.
**Time window and time zone**
- `start_date` and `end_date` accept `YYYY-MM-DD` or `YYYY-MM-DDTHH:00` (minutes must be `00`).
- The window is `[start, end)`. A date without an hour covers the whole day: `start_date=2026-10-20&end_date=2026-10-20` returns all of October 20.
- `timezone` (IANA, e.g. `America/Sao_Paulo`) defines how the dates are read and how days and hours are labeled in the response. Without `timezone` and without hours in the dates, days and hours are in UTC (same response as before).
- Unique metrics over a window are the sum of the unique metrics of each hour: a viewer who comes back in different hours is counted once per hour.
- Returns `400` for an invalid time zone, a time zone with a non whole-hour UTC offset (e.g. `Asia/Kolkata`), minutes other than `00`, or `end_date` not after `start_date`.
**Most recent data**: includes the current day.'
tags:
- Geographic Analytics
security:
- PandaAuth: []
parameters:
- name: videoId
in: path
required: true
description: Unique identifier of the video
schema:
type: string
- name: start_date
in: query
required: false
description: 'Start of the window: `YYYY-MM-DD` (start of the day) or `YYYY-MM-DDTHH:00`, in `timezone`.'
schema:
type: string
pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
example: '2026-10-20'
- name: end_date
in: query
required: false
description: 'End of the window, exclusive: `YYYY-MM-DDTHH:00` stops right before that hour; `YYYY-MM-DD` includes the whole day. Read in `timezone`.'
schema:
type: string
pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
example: '2026-10-21'
- name: timezone
in: query
required: false
description: IANA time zone used to read `start_date`/`end_date` and to label days and hours in the response (e.g. `America/Sao_Paulo`, `America/New_York`, `UTC`). When omitted and the dates have no hour, everything is in UTC.
schema:
type: string
example: America/Sao_Paulo
- name: granularity
in: query
required: false
description: '`total` (default), `day` or `hour`. `day` and `hour` require the location filters.'
schema:
type: string
enum:
- total
- day
- hour
default: total
- name: country
in: query
required: false
description: Country code, e.g. `BR`. Required for `day`/`hour`.
schema:
type: string
- name: region
in: query
required: false
description: Region name, e.g. `São Paulo`. Required for `day`/`hour`.
schema:
type: string
responses:
'200':
description: Video region analytics data retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/VideoRegionAnalytics'
examples:
OK:
summary: OK
value:
BR:
São Paulo:
view: 500
play: 58
unique_play: 29
unique_view: 117
'400':
$ref: '#/components/responses/BadRequestError'
operationId: getRegionByVideoId
x-operation-id-source: derived
components:
responses:
BadRequestError:
description: Invalid time window or time zone
content:
application/json:
schema:
type: object
properties:
errMsg:
type: string
examples:
invalid timezone:
value:
errMsg: timezone "Foo/Bar" is not a valid IANA timezone (e.g. America/Sao_Paulo)
minutes:
value:
errMsg: start_date must be on the hour (minutes must be 00)
schemas:
RegionAnalytics:
type: object
properties:
data:
type: array
items:
type: object
properties:
region:
type: string
example: Southeast
views:
type: integer
example: 2340
percentage:
type: number
example: 42.1
Metrics:
type: object
properties:
play:
type: integer
example: 12
view:
type: integer
example: 90
unique_play:
type: integer
example: 8
unique_view:
type: integer
example: 41
CityAnalytics:
type: object
properties:
data:
type: array
items:
type: object
properties:
city:
type: string
example: São Paulo
views:
type: integer
example: 850
percentage:
type: number
example: 15.2
VideoRegionAnalytics:
type: object
description: '`{ country: { region: metrics } }` for `granularity=total`; `{ country: { region: { key: metrics } } }` with keys `YYYY-MM-DD HH:00` (hour) or `YYYY-MM-DD` (day).'
additionalProperties:
type: object
additionalProperties:
type: object
VideoCityAnalytics:
type: object
description: '`{ country: { region: { city: { lat, lng, total | data } } } }`. `total` for `granularity=total`; `data` keyed by `YYYY-MM-DD HH:00` (hour) or `YYYY-MM-DD` (day).'
additionalProperties:
type: object
additionalProperties:
type: object
additionalProperties:
type: object
properties:
lat:
type: number
lng:
type: number
total:
$ref: '#/components/schemas/Metrics'
data:
type: object
additionalProperties:
$ref: '#/components/schemas/Metrics'
securitySchemes:
PandaAuth:
type: apiKey
in: header
name: Authorization
description: Panda API token (without Bearer prefix)
x-provenance:
method: searched
source: https://docs.pandavideo.com/reference
harvested: '2026-11-20'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.pandavideo.com/reference/analytics-general.md
- https://docs.pandavideo.com/reference/analytics-retention.md
- https://docs.pandavideo.com/reference/get_city-videoid.md
- https://docs.pandavideo.com/reference/get_city.md
- https://docs.pandavideo.com/reference/get_general-videoid.md
- https://docs.pandavideo.com/reference/get_general_hour_videos.md
- https://docs.pandavideo.com/reference/get_live-liveid.md
- https://docs.pandavideo.com/reference/get_live.md
- https://docs.pandavideo.com/reference/get_ranking-1.md
- https://docs.pandavideo.com/reference/get_ranking_unwatched.md
- https://docs.pandavideo.com/reference/get_region-videoid.md
- https://docs.pandavideo.com/reference/get_region.md
- https://docs.pandavideo.com/reference/get_retention-videoid.md
- https://docs.pandavideo.com/reference/get_type-videoid.md
- https://docs.pandavideo.com/reference/get_type.md
- https://docs.pandavideo.com/reference/get_users.md
- https://docs.pandavideo.com/reference/post_general_hour_videos.md
merge:
pages: 17
deduped: 24
conflicts_kept_first: 0