Panda Video General API

The General API from Panda Video — 1 operation(s) for general.

GitHub OpenAPI

Operations 1

GET /general/hour Get Best Times General Metrics #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pandavideo-com:pandavideo-com-general-api"
All apis
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.

Get an API 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 Specification

pandavideo-com-general-api-openapi.yml Raw ↑
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