Get audience insights (OAuth)
get_audience_insightsRetrieve YouTube audience insights by country, city, device, playback location, traffic source, subscriber status, content type, sharing, and cards; narrow results to a date range or specific video.
Instructions
Who watches and how: countries, cities, devices, playback locations (incl. embeds on websites), traffic sources, subscribers vs not, Shorts vs long-form, sharing, cards.
Each breakdown lists rows sorted by views with their share of the total. Requires OAuth.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_audience_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | When no dates are given: the last N days ending today. | |
| limit | No | Rows per breakdown, 1-250 (embedding/external sites stop at 25). | |
| end_date | No | End date YYYY-MM-DD, inclusive. | |
| video_id | No | Narrow every breakdown to one video on your channel. | |
| breakdowns | No | Subset of: countries (Views by viewer country (ISO code).), cities (Views by viewer city.), devices (Mobile, desktop, tablet, TV, ...), operating_systems (Android, iOS, Windows, ...), playback_locations (Where the video was played: YouTube watch page, Shorts feed, embedded, ...), embedding_sites (Websites that play the videos in an embedded player.), traffic_sources (How viewers found the videos: search, suggested, external, Shorts, ...), external_sites (Websites and apps that link viewers to the videos.), subscribed_status (Subscribers vs non-subscribers.), content_types (Shorts vs long-form vs live.), sharing_services (Where viewers share the videos: WhatsApp, copy link, ...), cards (Info card impressions, clicks and click rates.). Omit for: countries, devices, playback_locations, traffic_sources, subscribed_status, content_types. | |
| start_date | No | Start date YYYY-MM-DD, inclusive. Omit both dates to use `days`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||