> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Viewership and engagement metrics via the Livepeer API, Grafana, and Timeplus.

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

## Viewership API

The [Viewership API](https://livepeer.studio/docs/api-reference/viewership/get-viewership-metrics) (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](../player).
* **Custom player** - Use the `addMediaMetrics` (or equivalent) integration described in the [Livepeer Studio docs](https://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](https://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](https://livepeer.studio/docs/api-reference/viewership/get-viewership-metrics) and related pages.