Returns time-series ingest metrics (bitrate and frame rate) for a live stream. Use ?limit= to control the number of samples returned. Samples are collected ~once per minute.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /lives/{live_id}/stream_metrics
{live_id}/stream_metricsReturns time-series metrics (incoming bitrate and frame rate) collected during the broadcast of a live stream. Use this to render real-time charts of ingest quality (e.g., bitrate over time) in your dashboard.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /lives/{live_id}/stream_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 metrics you want to retrieve. | uuid |
Query Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
limit | integer | No | Number of data points to return. Defaults to 60. | min: 1, default: 60 |
Response
Success Response (200)
Returns an array of metric samples ordered by timestamp:
[
{ "timestamp": 1748430000, "bytes_in": "850000", "frame_rate": "30" },
{ "timestamp": 1748430060, "bytes_in": "870000", "frame_rate": "30" },
{ "timestamp": 1748430120, "bytes_in": null, "frame_rate": null }
]Response Schema (item)
| Field | Type | Description |
|---|---|---|
timestamp | integer | Unix timestamp (seconds) when the sample was collected. |
bytes_in | string | null | Bytes per second received from the encoder. null when no data for that sample. |
frame_rate | string | null | Frame rate (fps) reported by the ingest. null when no data for that sample. |
SamplingSamples are collected roughly once per minute while the live is online. Gaps (
nullvalues) can appear when the encoder briefly disconnects or stops sending data.
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>/stream_metrics' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'cURL — limit to last 30 samples
curl -X GET \
'https://api-v2.pandavideo.com.br/lives/<live_id>/stream_metrics?limit=30' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'