Get top-performing videos (OAuth)
get_top_videosRetrieve a channel's top videos by views, watch time, likes, comments, shares, subscribers, or engagement for a selected date range, including titles and key metrics.
Instructions
Your channel's top N videos by a metric over a date range, with titles and key metrics.
Requires OAuth; returns an OAUTH_REQUIRED error with setup steps otherwise.
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_top_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | When no dates are given: the last N days ending today. | |
| limit | No | How many videos, 1-200. | |
| metric | No | views, watch_time, likes, comments, shares, subscribers, or engagement (likes+comments+shares). | views |
| end_date | No | End date YYYY-MM-DD, inclusive. | |
| start_date | No | Start date YYYY-MM-DD, inclusive. Omit both dates to use `days`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||