Returns aggregated buffering metrics for a live stream over the last ~10 minutes. The response is a nested object: outer keys are time buckets, inner objects hold numeric counters (buffering count, viewers, average buffer duration, etc.).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /lives/{live_id}/buffering_metrics
{live_id}/buffering_metricsReturns aggregated buffering metrics for a live stream, over the last ~10 minutes. Use this to surface buffering trends (frequency, duration, viewer impact) on a real-time dashboard or to drive alerts on quality degradation.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /lives/{live_id}/buffering_metrics
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
live_id | string (uuid) | Yes | ID of the live stream whose buffering metrics to retrieve. | uuid |
Response
Success Response (200)
Returns a nested object. Outer keys are time-bucket identifiers (timestamps or interval labels); each inner object holds numeric counters for that bucket (e.g., buffering count, average buffer duration, viewers in the bucket).
{
"1748430000": { "buffering_count": 12, "viewers": 320, "avg_buffer_ms": 850 },
"1748430060": { "buffering_count": 8, "viewers": 318, "avg_buffer_ms": 720 },
"1748430120": { "buffering_count": 3, "viewers": 322, "avg_buffer_ms": 410 }
}Response Schema
| Level | Type | Description |
|---|---|---|
| (root) | object | Map of time-bucket identifier (string) → bucket data (object). |
(root).<bucket> | object | Map of metric name (string) → numeric value. |
(root).<bucket>.<metric> | number | Counter or aggregate for that bucket. Metric names are implementation-defined (e.g., buffering_count, viewers, avg_buffer_ms). |
Window & samplingThe data covers the last ~10 minutes of activity. For only the last 1-minute window, use Last Buffering Metrics. Exact bucket size and metric names may evolve — always parse the structure dynamically (do not assume a fixed metric set).
Error Responses
- 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Live not found for the given
live_id. - 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/lives/<live_id>/buffering_metrics' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'Related
- Get Stream Metrics for Live Stream — ingest bitrate / frame rate samples.