---
title: "Download video playlists analytics"
method: GET
path: "/lives/{liveId}/video-playlists-analytics"
tags: ["Live"]
---

# Download video playlists analytics

`GET /lives/{liveId}/video-playlists-analytics`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/lives/{liveId}/video-playlists-analytics`
- Auth: HTTP bearer

Download analytics data for all video playlist layers in a broadcast.

Records when videos started/stopped playing and the concurrent viewer count at each moment.

> **Limited Access**: This endpoint is available on request.
> Contact [hello@livereacting.com](mailto:hello@livereacting.com) to request access.

**Use cases:**
- Analyze which videos had the most viewers
- Track viewer engagement patterns during broadcasts
- Export data to spreadsheets for reporting

## Path parameters

- `liveId` string, required

## Query parameters

- `format` 'json' | 'csv'
- `timezone` string
- `startDate` string, date
- `endDate` string, date
- `limit` integer
- `offset` integer

## Response `200`

Analytics data

- VideoPlaylistsAnalyticsResponse
  - `data` VideoPlaylistAnalyticsEvent[]
    - `fileId` string: File identifier
    - `fileName` string: File name
    - `sceneName` string: Scene name where video played
    - `action` 'start' | 'end': Whether video started or ended playing
    - `timestamp` string, date-time: When the action occurred (ISO 8601)
    - `concurrentLiveViews` integer: Number of concurrent viewers at that moment
  - `meta` object
    - `liveId` string: Live stream ID
    - `projectId` string: Project ID
    - `total` integer: Total number of matching events
    - `limit` integer: Applied limit value
    - `offset` integer: Applied offset value
    - `hasMore` boolean: Whether more records exist beyond current page

## Other responses

- `400`: Invalid parameters
- `401`: Authentication failed
- `403`: Playlist analytics is not enabled for this account (available on request)
- `404`: Live stream not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/livereacting/apis/livereacting-api.md) · [All operations](https://skmtc.dev/livereacting/apis/livereacting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livereacting/apis/livereacting-api/revisions/17a9f1677fbf?raw)