Get per-video analytics (OAuth)
get_video_analyticsRetrieve analytics for a single YouTube video across a selected date range, including summary metrics, traffic sources, audience retention, and viewer demographics.
Instructions
Analytics for one video: summary metrics, traffic sources, audience retention curve, and viewer demographics.
Requires OAuth; returns an OAUTH_REQUIRED error with setup steps otherwise.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video_id": "<video_id>"
},
"name": "get_video_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | When no dates are given: the last N days ending today. | |
| end_date | No | End date YYYY-MM-DD, inclusive. | |
| sections | No | Subset of: summary, traffic_sources, retention, demographics. Omit for all. | |
| video_id | Yes | ID of a video on your channel. | |
| start_date | No | Start date YYYY-MM-DD, inclusive. Omit both dates to use `days`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||