Get YouTube demographics

Returns audience demographic insights for a YouTube channel, broken down by age, gender, and/or country. 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. Requires the Analytics add-on.

GET /v1/analytics/youtube/demographics

Returns audience demographic insights for a YouTube channel, broken down by age, gender, and/or country. 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. Requires the Analytics add-on.

Parameters

• accountId (query, string) required — The Zernio SocialAccount ID for the YouTube account

• breakdown (query, string) — Comma-separated list of demographic dimensions: age, gender, country. Defaults to all three if omitted.

• startDate (query, string) — Start date in YYYY-MM-DD format. Defaults to 90 days ago.

• endDate (query, string) — End date in YYYY-MM-DD format. Defaults to 3 days ago (YouTube data latency).

Responses

200 — Demographic insights data

• success (boolean)
• accountId (string) — The Zernio SocialAccount ID
• platform (string)
• demographics (object) — Object keyed by breakdown dimension (age, gender, country)
• dateRange (object)
• note (string)

400 — Bad request (invalid parameters or not a YouTube account)

• error (string)

401

402 — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.

• error (string)
• code (string)

403 — Access denied to this account

• error (string)

404 — Account not found

• error (string)

412 — YouTube Analytics scope not granted

• success (boolean)
• error (string)
• code (string)
• scopeStatus (object)