Retrieve analytics data for all live streams broadcast in the given date range. Returns per-live metrics including traffic usage, average and unique viewers, chat message count, retention, and start/end timestamps.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /live
Retrieve analytics data for all live streams broadcast in the given date range. Returns per-live metrics including traffic usage, average and unique viewers, chat message count, retention, and start/end timestamps.
Different hostThis endpoint uses
data.pandavideo.cominstead of the standardapi-v2.pandavideo.com. Make sure to use the correct host when calling it.
AuthorizationRequires a valid Panda API key in the
Authorizationheader. The metrics returned correspond to the organization that owns the API key.
HTTP Method & Path
GET /live
Base URL: https://data.pandavideo.com
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) |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date | string | Yes | Start date of the range. Format: YYYY-MM-DD |
end_date | string | Yes | End date of the range. Format: YYYY-MM-DD |
Request Body
No request body is required.
Response
Success Response (200)
Returns an object with two levels of dynamic keys:
- Outer key: the live stream ID (
live_id, prefixed with6c697665-— hex of "live") - Inner key: the broadcast date (
YYYY-MM-DD) - Value: the metrics object for that broadcast
{
"6c697665-bbf9-4825-897c-a9b8a384429b": {
"2026-04-30": {
"live_id": "6c697665-bbf9-4825-897c-a9b8a384429b",
"title": "Live 2026-04-30",
"retention": {},
"traffic_usage": 2248330,
"avarage_views": 1,
"unique_views": 1,
"messages_count": 0,
"finished_at": "2026-04-30T16:11:41.464Z",
"started_at": "2026-04-30T15:58:41.763Z",
"duration": 12
}
},
"6c697665-2e4e-4a37-a688-b50252549f61": {
"2026-05-19": {
"live_id": "6c697665-2e4e-4a37-a688-b50252549f61",
"title": "Live 2026-04-30",
"retention": {},
"traffic_usage": 15887288,
"avarage_views": 2,
"unique_views": 2,
"messages_count": 0,
"finished_at": "2026-05-19T20:03:18.553Z",
"started_at": "2026-05-19T19:10:54.008Z",
"duration": 52
}
}
}Response Schema
Each daily metrics object contains the following fields:
| Field | Type | Description |
|---|---|---|
live_id | string (uuid) | Unique ID of the live stream. Prefix: 6c697665- (hex of "live") |
title | string | Title of the live broadcast |
retention | object | Retention buckets across the broadcast duration (empty when no viewers stayed long enough to register) |
traffic_usage | integer | Bandwidth consumed by this broadcast, in bytes |
avarage_views | integer | Average concurrent viewers during the broadcast (note: API spelling is avarage_views) |
unique_views | integer | Unique viewers during the broadcast |
messages_count | integer | Total chat messages sent during the broadcast |
finished_at | string (ISO 8601) | Timestamp when the broadcast ended |
started_at | string (ISO 8601) | Timestamp when the broadcast started |
duration | integer | Broadcast duration in minutes |
Field spelling: The field isavarage_views(with the typo) — this is the actual key returned by the API.
Error Responses
- 401 Unauthorized: API token inválido ou ausente
- 403 Forbidden: Token sem permissão para acessar este recurso
- 422 Unprocessable Entity: Parâmetros de data inválidos (formato ou intervalo)
- 500 Internal Server Error: Erro no servidor
Example Usage
cURL
curl -X GET \
'https://data.pandavideo.com/live?start_date=2026-04-25&end_date=2026-05-25' \
-H 'Authorization: your_api_token_here'