---
title: "Get YouTube demographics"
method: GET
path: "/v1/analytics/youtube/demographics"
tags: ["Analytics"]
---

# Get YouTube demographics

`GET /v1/analytics/youtube/demographics`

Returns audience demographic insights for a YouTube channel, broken down by age, gender, and/or country.
Pass videoId to get the audience profile of a single video instead of the whole channel.
Age and gender values are viewer percentages (0-100). Country values are view counts.
Data is based on signed-in viewers only, with a 2-3 day delay. YouTube suppresses demographics
for videos with too few signed-in views, so low-traffic videos can return empty breakdowns.
Requires the Analytics add-on.

## Query parameters

- `accountId` string, required
- `videoId` string
- `breakdown` string
- `startDate` string, date
- `endDate` string, date

## Response `200`

Demographic insights data

- YouTubeDemographicsResponse
  - `success` boolean
  - `accountId` string — The Zernio SocialAccount ID
  - `platform` string
  - `videoId` string — Present only when demographics are scoped to a single video
  - `title` string, nullable — Video title (video mode only)
  - `publishedAt` string, date-time, nullable — Video publish date (video mode only)
  - `demographics` object — Object keyed by breakdown dimension (age, gender, country)
  - `dateRange` object
    - `startDate` string
    - `endDate` string
  - `provisionalSince` string, date — Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube.
  - `note` string

## Other responses

- `400` — Bad request (invalid parameters or not a YouTube account)
- `401` — Unauthorized
- `402` — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.
- `403` — Access denied to this account
- `404` — Account not found, or the video does not exist / does not belong to this YouTube channel
- `412` — YouTube Analytics scope not granted

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)