search_content
Read-only
Search YouTube for videos, channels, or playlists. Filter results by content type, region, duration, or publish date, and paginate using a page token.
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 |
|---|---|---|---|
| order | No | Sort order for results. Use 'date' for newest first, 'viewCount' for most watched, 'rating' for top rated. | |
| page_token | No | Token from a previous response to fetch the next page of results. | |
| max_results | No | Default is 5. Max is 50. | |
| region_code | No | ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'IN') to geo-restrict search results. | |
| content_type | No | Comma-separated list (e.g., 'video,channel,playlist') | |
| search_query | Yes | Search query | |
| video_duration | No | Filter by video duration — short (<4 min), medium (4-20 min), long (>20 min). Only applies when content_type includes 'video'. | |
| 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_definition | No | Filter by video quality — 'hd' or 'standard'. Only applies when content_type includes 'video'. |