Skip to main content

Documentation Index

Fetch the complete documentation index at: https://na-36-docs-v2.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Livepeer Studio provides viewership and engagement data so you can measure plays, watch time, and playback quality.

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.
For exact endpoint paths and parameters, see the Viewership API reference and related pages.
Last modified on March 26, 2026