get
https://api-v2.pandavideo.com.br/analytics/live//viewers
Returns a real-time snapshot of viewer count and status for a live stream. Use this for 'watching now' counters. For viewer count over time, use the historic viewers endpoint.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
GET /analytics/live/{live_id}/viewers
{live_id}/viewersReturns the real-time viewer count and current status of a live stream. Use this to display a "watching now" counter or to drive realtime widgets on a broadcaster dashboard.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /analytics/live/{live_id}/viewers
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 viewer count you want to retrieve. | uuid |
Response
Success Response (200)
{
"id": "11111111-2222-3333-4444-555555555555",
"title": "My live stream",
"status": "online",
"started_at": "2026-05-28T15:00:00.000Z",
"ended_at": null,
"viewers": 320
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | ID of the live stream. |
title | string | Title of the live stream. |
status | string | Current status. Enum: online, offline, canceled, finished, finished_imported. |
started_at | string | null | When the live started (ISO 8601). null if not started yet. |
ended_at | string | null | When the live ended (ISO 8601). null if still active. |
viewers | integer | Current number of concurrent viewers. 0 when the live is offline. |
Real-time vs historicThis endpoint returns a snapshot of the current viewer count. For viewer count over time (charts), use Get Historic Viewer Data for Live Stream.
Error Responses
- 400 Bad Request —
live_idis missing or not a valid UUID. - 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/analytics/live/<live_id>/viewers' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'Related
- Get Historic Viewer Data for Live Stream — viewer count over time.
- Get Stream Metrics for Live Stream — ingest bitrate / frame rate samples.
- Get Buffering Metrics for Live Stream — buffering counters over the last 10 minutes.