search_youtube_channel_videos
Search for specific videos within a YouTube channel using keywords to find relevant content without browsing all uploads.
Instructions
Search for videos within a channel by keyword (public data).
When to use: Use this tool when you want to find videos by keyword without enumerating the full uploads playlist.
Important:
- This tool uses the YouTube Search API (search.list).
- Search is quota-expensive (about 100 units per page).
- Results may be capped by YouTube API behavior for channel searches.
Pagination:
- Read nextPageToken (or next_page_token) from the response.
- Pass it back as page_token (or next_page_token) to fetch the next page.
Returns:
- items: hydrated video resources (videos.list)
- nextPageToken / next_page_token
- quotaEstimate
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_ref | Yes | ||
| query | Yes | ||
| page_token | No | ||
| next_page_token | No | ||
| max_videos | No | ||
| include_shorts | No | ||
| include_live | No | ||
| parts_level | No | basic | |
| order | No | relevance |