search_videos
Search YouTube videos using queries with filters for upload date, duration, and other metadata to find specific content.
Instructions
Search videos on YouTube via yt-dlp (ytsearch). Returns list of matching videos with metadata. Optional: limit, offset (pagination), uploadDateFilter (hour|today|week|month|year), dateBefore, date, matchFilter (e.g. "!is_live"), response_format (json|markdown).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search query | |
| limit | No | Max results (default 10) | |
| offset | No | Skip first N results (pagination) | |
| uploadDateFilter | No | Filter by upload date (relative to now) | |
| dateBefore | No | yt-dlp --datebefore, e.g. "now-1year" or "20241201" | |
| date | No | yt-dlp --date, exact date e.g. "20231215" or "today-2weeks" | |
| matchFilter | No | yt-dlp --match-filter, e.g. "!is_live" or "duration < 3600 & like_count > 100" | |
| response_format | No | Format of the human-readable content: json (default) or markdown |