list_youtube_channel_videos
List all public videos from a YouTube channel using its uploads playlist. Supports pagination, filtering by shorts and live streams, and multiple order strategies.
Instructions
List videos for a channel (public data), with safe defaults.
Default behavior (safe + complete):
- Uses the channel's uploads playlist (uploadsPlaylistId) to paginate
through all uploaded videos.
Parameters:
channel_ref:
Same formats as resolve_youtube_channel.
max_videos:
Hard limit per tool call. The tool may return fewer items and set
truncated=true.
page_token:
Token for pagination (from previous response nextPageToken).
Alias: you may also pass next_page_token (some agents prefer it).
include_shorts:
Default false. If true, includes Shorts (best-effort classification).
include_live:
Default false. If true, includes live/upcoming videos (best-effort).
parts_level:
- basic (default): snippet + statistics + contentDetails
- full: also requests status/liveStreamingDetails (heavier payload)
order_strategy:
- uploads_playlist (default): low quota, paginated.
- local_sort: fetches a bounded subset then sorts locally.
(Not paginated; page_token must be null.)
- search_api: uses YouTube Search API ordering (expensive, capped).
Explicit opt-in only.
order_by:
- date (default)
- viewCount, likeCount, commentCount, duration
Note: search_api supports only date and viewCount.
Returns (structured JSON): - items: video[] (YouTube API video resources) - nextPageToken: string | null - next_page_token: string | null (alias of nextPageToken for agent friendliness) - quotaEstimate: {estimatedUnits,strategy,notes[]} - truncated: bool - appliedMaxVideos: int - appliedOrder: {strategy, by}
Quota/performance notes: - Search API calls are expensive (quota ~100/unit per call) and may be capped for channels. - local_sort is bounded by max_videos and max_pages.
Safety notes: - Public data only; no private playlists/videos. - No file/network access except YouTube Data API endpoints.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_by | No | date | |
| max_videos | No | ||
| page_token | No | ||
| channel_ref | Yes | ||
| parts_level | No | basic | |
| include_live | No | ||
| include_shorts | No | ||
| order_strategy | No | uploads_playlist | |
| next_page_token | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||