search_content
Find movies and TV shows with torrent download options by searching titles, genres, years, ratings, or quality. Returns metadata and magnet links for downloading content.
Instructions
Search for movies and TV shows by title, genre, year, rating, or quality. Returns matching content with metadata (title, year, genres, IMDb/TMDB ratings) and torrent download options (magnet links, quality, seeders, file size). This is the primary tool — use it first when a user asks to find, download, or learn about a movie or TV show. Results include a content_id needed by get_watch_providers and get_credits. For TV shows, you can filter by season/episode. Season/episode can also be auto-detected from the query (e.g. 'Bluey s01e05'). IMPORTANT: When presenting results to users, make magnet links clickable using markdown format Download, include the contentUrl for browsing all seasons/episodes, and present the information in a user-friendly format rather than raw tables.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query — typically a movie or TV show title (e.g. 'The Matrix', 'Breaking Bad'). Supports partial matches. Season/episode can be included in query (e.g. 'Bluey s01e05'). | |
| type | No | Filter by content type: 'movie' or 'show' | |
| genre | No | Filter by genre name. Common values: Action, Adventure, Animation, Comedy, Crime, Documentary, Drama, Family, Fantasy, History, Horror, Music, Mystery, Romance, Science Fiction, Thriller, War, Western | |
| year_min | No | Minimum release year (e.g. 2020) | |
| year_max | No | Maximum release year (e.g. 2025) | |
| min_rating | No | Minimum IMDb rating (0-10). Example: 7 for well-rated content | |
| quality | No | Filter torrents by resolution | |
| language | No | ISO 639-1 language code to filter torrents (e.g. 'en' for English, 'es' for Spanish, 'fr' for French). Lowercase 2-letter code. | |
| audio | No | Filter torrents by audio codec (e.g. 'aac', 'flac', 'atmos', 'opus', 'dts'). Substring match. | |
| hdr | No | Filter torrents by HDR format | |
| availability | No | Filter by torrent availability: 'available' (has seeders), 'unavailable' (no seeders), 'all' (default). | |
| season | No | Season number for TV shows (0-99). Use with type='show' to filter torrents for a specific season. | |
| episode | No | Episode number for TV shows (0-999). Use with season to filter torrents for a specific episode. | |
| locale | No | Locale for translated titles and overviews (e.g. 'es' for Spanish, 'fr' for French). If omitted, returns English. | |
| sort | No | Sort order for results | relevance |
| page | No | Page number (default: 1, max: 1000) | |
| limit | No | Results per page (default: 20, max: 50) | |
| country | No | ISO 3166-1 country code for streaming availability (e.g. US, ES, GB, DE). If provided, results include which streaming services offer each title. If omitted, no streaming data is returned. | |
| compact | No | When true, returns shorter magnet links (hash only, no trackers) to reduce output size. Magnets are still clickable. Recommended for large result sets or when context window is limited. |