Panda Video General API
The General API from Panda Video — 1 operation(s) for general.
The General API from Panda Video — 1 operation(s) for general.
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-general-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 Video API 2 General API
description: 'API for video analytics and live streaming data with comprehensive tracking capabilities.
This API provides:
- **Video Analytics**: Views, plays, retention, and engagement metrics
- **Live Streaming Analytics**: Real-time viewer data and stream performance
- **Geographic Analytics**: Regional and city-based viewer distribution
- **Device Analytics**: Browser, OS, and device-specific data
- **Real-time Statistics**: Current viewer counts and live metrics
- **Beacon Tracking**: Event tracking for video and live interactions
## Data Sources
The analytics API aggregates data from multiple sources:
- **Real-time data**: PostgreSQL database (last 7 days)
- **Historical data**: S3 storage (archived data older than 3 days)
- **Cache**: Redis for frequently accessed data
## Authentication
All requests require a Panda API token in the Authorization header.'
version: 1.0.0
contact:
name: Panda Team
email: support@panda.video
license:
name: Proprietary
url: https://panda.video/terms
servers:
- url: https://data.pandavideo.com
description: Production Analytics API
- url: http://localhost:1935
description: Local Development
tags:
- name: General
paths:
/general/hour:
get:
summary: Get Best Times General Metrics
description: 'Retrieve hourly viewing metrics across all videos for the given date range. Returns two views of the same data: raw entries per video grouped by date and hour, and aggregated totals grouped by date and 2-hour time buckets. Video IDs are `video_external_id` values.
**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**: with `timezone` (or hours in the dates) the current day is included up to the last closed hour (hourly processing at minute 5 of each hour, UTC). Without `timezone`, data goes up to the previous day, available after the daily processing at 00:30 UTC.'
operationId: get_general_hour
parameters:
- name: start_date
in: query
required: true
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: true
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
responses:
'200':
description: 'Hourly viewing metrics. Contains two views of the same data: raw entries (views_data) and aggregated 2-hour buckets (aggregated_data).'
content:
application/json:
schema:
type: object
properties:
views_data:
type: object
description: Raw hourly entries keyed by date (YYYY-MM-DD).
additionalProperties:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Video ID
hour:
type: integer
description: Hour of the day in 24h format (0-23)
view:
type: integer
description: Total views in that hour
play:
type: integer
description: Total plays in that hour
unique_view:
type: integer
description: Unique viewers in that hour
unique_play:
type: integer
description: Unique plays in that hour
aggregated_data:
type: object
description: Totals keyed by date (YYYY-MM-DD). Each value is an object whose keys are 2-hour buckets (0-2, 2-4, 4-6, 6-8, 8-10, 10-12, 12-14, 14-16, 16-18, 18-20, 20-22, 22-00).
additionalProperties:
type: object
additionalProperties:
type: object
properties:
total_view:
type: integer
description: Total views in the bucket
total_play:
type: integer
description: Total plays in the bucket
total_unique_view:
type: integer
description: Total unique viewers in the bucket
total_unique_play:
type: integer
description: Total unique plays in the bucket
timezone:
type: string
description: Time zone used for the window and the keys. Only present when `timezone` or hours were sent.
example: America/Sao_Paulo
examples:
OK:
summary: OK
value:
views_data:
'2026-05-25':
- id: 07c8153a-fb76-43a8-bfe3-15280d9783ae
hour: 11
view: 1
play: 1
unique_view: 1
unique_play: 1
'2026-05-24': []
aggregated_data:
'2026-05-25':
0-2:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
2-4:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
4-6:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
6-8:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
8-10:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
10-12:
total_view: 4
total_play: 4
total_unique_view: 4
total_unique_play: 4
12-14:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
14-16:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
16-18:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
18-20:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
20-22:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
22-00:
total_view: 0
total_play: 0
total_unique_view: 0
total_unique_play: 0
'400':
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)
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties: {}
examples:
Unauthorized:
summary: Unauthorized
value:
statusCode: 401
error: Unauthorized
message: Invalid or missing API token
'403':
description: Forbidden
content:
application/json:
schema:
type: object
properties: {}
examples:
Forbidden:
summary: Forbidden
value:
statusCode: 403
error: Forbidden
message: You do not have permission to access this resource
'422':
description: Unprocessable Entity
content:
application/json:
schema:
type: object
properties: {}
examples:
UnprocessableEntity:
summary: Unprocessable Entity
value:
statusCode: 422
error: Unprocessable Entity
message: Invalid date parameters
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties: {}
examples:
InternalServerError:
summary: Internal Server Error
value:
statusCode: 500
error: Internal Server Error
message: Something went wrong
tags:
- General
components:
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-live-stream-viewers-history.md
- https://docs.pandavideo.com/reference/analytics-live-stream-viewers.md
- https://docs.pandavideo.com/reference/get-best-times-general-metrics.md
- https://docs.pandavideo.com/reference/get_analytics-live-live-id-viewers-historic.md
- https://docs.pandavideo.com/reference/get_analytics-live-live-id-viewers.md
- https://docs.pandavideo.com/reference/get_browser-1.md
- https://docs.pandavideo.com/reference/get_browser-video-id-1.md
- https://docs.pandavideo.com/reference/get_city-1.md
- https://docs.pandavideo.com/reference/get_city-video-id-1.md
- https://docs.pandavideo.com/reference/get_country-1.md
- https://docs.pandavideo.com/reference/get_country-video-id-1.md
- https://docs.pandavideo.com/reference/get_general-video-id.md
- https://docs.pandavideo.com/reference/get_os-1.md
- https://docs.pandavideo.com/reference/get_os-video-id-1.md
- https://docs.pandavideo.com/reference/get_ranking-2.md
- https://docs.pandavideo.com/reference/get_realtime.md
- https://docs.pandavideo.com/reference/get_referrer-1.md
- https://docs.pandavideo.com/reference/get_referrer-video-id-1.md
- https://docs.pandavideo.com/reference/get_region-1.md
- https://docs.pandavideo.com/reference/get_retention-video-id.md
- https://docs.pandavideo.com/reference/post_beacon-live.md
- https://docs.pandavideo.com/reference/post_beacon-video.md
merge:
pages: 22
deduped: 96
conflicts_kept_first: 0