v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB

Get viewers from a live

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.

get/live/{live_id}/viewers

Path parameters

live_idstring uuid required

ID of the live stream.

Response

Real-time viewer count and live stream status.

idstring uuid

ID of the live stream.

titlestring

Title of the live stream.

status'online' | 'offline' | 'canceled' | 'finished' | 'finished_imported'

Current status of the live.

started_atstring date-time nullable

When the live started (ISO 8601), or null if not started yet.

ended_atstring date-time nullable

When the live ended (ISO 8601), or null if still active.

viewersinteger

Current number of concurrent viewers. 0 when the live is offline.