discover_movies
Find movies using filters for genre, language, year range, rating, and sorting to match specific criteria like Japanese sci-fi from 2020 or Korean dramas with high ratings.
Instructions
Discover movies with advanced filters including genre, language, year range, rating, and sorting. Perfect for finding movies that match specific criteria like 'Japanese sci-fi movies from 2020 onwards with rating above 7' or 'Korean dramas with high ratings'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| with_genres | No | Genre IDs comma-separated (28=Action, 12=Adventure, 16=Animation, 35=Comedy, 80=Crime, 99=Documentary, 18=Drama, 10751=Family, 14=Fantasy, 36=History, 27=Horror, 10402=Music, 9648=Mystery, 10749=Romance, 878=Science Fiction, 10770=TV Movie, 53=Thriller, 10752=War, 37=Western) | |
| with_original_language | No | Filter by original language using ISO 639-1 codes. Single language (e.g., 'ja') or comma-separated for multiple (e.g., 'ja,ko,zh') | |
| min_year | No | Minimum release year (e.g., 2020 for movies from 2020 onwards) | |
| max_year | No | Maximum release year (e.g., 2023 for movies up to 2023) | |
| min_rating | No | Minimum vote average (0-10) | |
| max_rating | No | Maximum vote average (0-10) | |
| min_vote_count | No | Minimum number of votes (helps filter reliable ratings) | |
| sort_by | No | Sort order (popularity.desc, popularity.asc, vote_average.desc, vote_average.asc, release_date.desc, release_date.asc) | |
| page | No | Page number (default: 1) |