---
title: "Get YouTube broadcast analytics"
method: GET
path: "/lives/{liveId}/youtube-analytics"
tags: ["Live"]
---

# Get YouTube broadcast analytics

`GET /lives/{liveId}/youtube-analytics`

## Request

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

Retrieve YouTube Analytics data for a specific broadcast, including views, watch time,
engagement, revenue, traffic sources, demographics, devices, and geography.

This is separate from `/lives/{liveId}/video-playlists-analytics` which tracks internal
video playlist playback events. This endpoint queries the YouTube Analytics API directly
for the YouTube video associated with the broadcast.

Included with every paid plan.

**Important notes:**
- Revenue data may be `null` for non-monetized channels
- Data for live broadcasts may have latency — YouTube Analytics is not real-time
- For multi-destination broadcasts (multiple YouTube accounts), specify `accountId`
- YouTube analytics consent must be granted first via `/auth/youtube/analytics`

## Path parameters

- `liveId` string, required

## Query parameters

- `accountId` string
- `startDate` string, date
- `endDate` string, date
- `format` 'json' | 'csv'

## Response `200`

Analytics data

- object
  - `data` object
    - `overview` object, nullable: Aggregate metrics: views, estimatedMinutesWatched, averageViewDuration, likes, dislikes, comments, shares, subscribersGained, subscribersLost, etc.
    - `livestream` object, nullable: Live-specific metrics: averageConcurrentViewers, peakConcurrentViewers
    - `revenue` object, nullable: Revenue metrics (null for non-monetized channels): estimatedRevenue, estimatedAdRevenue, grossRevenue, cpm, adImpressions, etc.
    - `revenueByAdType` object[]: Revenue broken down by ad type
    - `trafficSources` object[]: Views and watch time by traffic source type
    - `dailyTrend` object[]: Daily views and watch time
    - `demographics` object
      - `ageGroups` object[]
      - `genders` object[]
    - `devices` object[]: Views and watch time by device type
    - `geography` object[]: Views and watch time by country
  - `meta` object
    - `liveId` string
    - `projectId` string
    - `accountId` string
    - `channelTitle` string
    - `startDate` string, date
    - `endDate` string, date
    - `dataLatencyNotice` boolean: True when the broadcast is still live (data may be delayed)
    - `revenueAvailable` boolean: Whether revenue data is available for this channel

## Other responses

- `400`: Validation error or account selection required
- `401`: Authentication failed
- `403`: Feature not available or analytics consent required
- `404`: Live stream not found
- `429`: Rate limit exceeded
- `502`: YouTube Analytics platform error

---

[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)