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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Content type to discover: "movie" or "tv" (default "movie") | |
| language | No | ISO 639-1 language code (e.g. "en-US"). Default: en-US | |
| page | No | Page number (1-500, default 1) | |
| sort_by | No | Sort field (e.g. "popularity.desc", "vote_average.desc", "revenue.desc", "primary_release_date.desc") | |
| with_genres | No | Comma-separated genre IDs to filter (e.g. "28,12" for Action+Adventure) | |
| year | No | Filter by release year (movies only) | |
| primary_release_year | No | Filter by primary release year (movies only) | |
| first_air_date_year | No | Filter by first air date year (TV only) | |
| vote_average_gte | No | Minimum vote average (0-10) | |
| vote_average_lte | No | Maximum vote average (0-10) | |
| with_original_language | No | ISO 639-1 original language filter (e.g. "en", "ko", "ja") | |
| region | No | ISO 3166-1 region for release dates (e.g. "US", "GB") | |
| include_adult | No | Include adult content (default false) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. |