Discover Movies & TV
tmdb.movies.discoverRead-onlyIdempotent
Discover movies or TV shows by filtering on genre, year, rating, language, and sort order using TMDB data.
Instructions
Discover movies or TV shows by genre, year, rating, language, and sort order (TMDB)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-500, default 1) | |
| type | No | Content type to discover: "movie" or "tv" (default "movie") | |
| year | No | Filter by release year (movies only) | |
| region | No | ISO 3166-1 region for release dates (e.g. "US", "GB") | |
| sort_by | No | Sort field (e.g. "popularity.desc", "vote_average.desc", "revenue.desc", "primary_release_date.desc") | |
| language | No | ISO 639-1 language code (e.g. "en-US"). Default: en-US | |
| with_genres | No | Comma-separated genre IDs to filter (e.g. "28,12" for Action+Adventure) | |
| include_adult | No | Include adult content (default false) | |
| vote_average_gte | No | Minimum vote average (0-10) | |
| vote_average_lte | No | Maximum vote average (0-10) | |
| first_air_date_year | No | Filter by first air date year (TV only) | |
| primary_release_year | No | Filter by primary release year (movies only) | |
| with_original_language | No | ISO 639-1 original language filter (e.g. "en", "ko", "ja") |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. | |
| result | No | Tool response payload. Shape varies per tool — consult the tool description and inputSchema. May be an object, array, string, or number depending on the upstream provider response. |