search_content
Read-only
Search YouTube for videos, channels, or playlists using keyword queries. Filter results by content type, duration, quality, region, and publish date. Supports pagination.
Instructions
Search YouTube for videos, channels, or playlists. Returns items[].id (videoId/channelId/playlistId) and items[].snippet (title, description, thumbnails, channelTitle, publishedAt). Use content_type to filter by resource type. Use page_token from a previous response to paginate additional pages.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search_query | Yes | Search query | |
| max_results | No | Default is 5. Max is 50. | |
| content_type | No | Comma-separated list (e.g., 'video,channel,playlist') | |
| order | No | Sort order for results. Use 'date' for newest first, 'viewCount' for most watched, 'rating' for top rated. | |
| published_after | No | RFC 3339 datetime (e.g., '2024-01-01T00:00:00Z'). Only return results published after this time. | |
| published_before | No | RFC 3339 datetime (e.g., '2024-12-31T23:59:59Z'). Only return results published before this time. | |
| video_duration | No | Filter by video duration — short (<4 min), medium (4-20 min), long (>20 min). Only applies when content_type includes 'video'. | |
| video_definition | No | Filter by video quality — 'hd' or 'standard'. Only applies when content_type includes 'video'. | |
| region_code | No | ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'IN') to geo-restrict search results. | |
| page_token | No | Token from a previous response to fetch the next page of results. |