Viewership API
The Viewership API (and related endpoints) provides:- Realtime viewership — Current viewer count and error rate (requires Player SDK 4.2.0+).
- Usage metrics — Views (play intent), minutes watched. Data refreshes about every 5 minutes; new uploads may take up to an hour to appear.
- Performance metrics — Error rate, time to first frame (TTFF), rebuffer ratio, exit-before-starts.
- Dimensions — Filter by video (playback ID, CID), browser, device, OS, geography, time zone, time period.
Registering views
- Livepeer Player — Metrics are collected automatically when you use the Livepeer Player.
- Custom player — Use the
addMediaMetrics(or equivalent) integration described in the Livepeer Studio docs so views and quality events are reported.
Other integrations
- Grafana — Use the viewership/usage APIs to build dashboards. See the Livepeer Studio docs for examples.
- Timeplus — Similar use of the API for real-time or historical analytics.