Discover TV shows (filters)
discover_tvRead-only
Filter and discover TV shows by genre, air date, rating, runtime, network, and watch provider.
Instructions
Find TV shows by structured filters (genres, first-air year or date range, rating range, vote count, runtime, language, companies, networks, keywords, watch providers, sort). The TV counterpart of discover_movies; use with_networks for 'HBO shows', etc.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number for pagination. | |
| year | No | Release / first-air year. | |
| sort_by | No | TMDB sort, e.g. 'popularity.desc', 'vote_average.desc', 'primary_release_date.desc'. | |
| language | No | Override the response language (ISO-639-1, optionally with a region), e.g. 'ru-RU' or 'en-US'. Localizes titles/overviews/genre names. Defaults to the server's TMDB_LANGUAGE. | |
| min_votes | No | Minimum vote count (filters obscure titles). | |
| max_rating | No | Maximum vote average (0-10). | |
| min_rating | No | Minimum vote average (0-10). | |
| max_runtime | No | Maximum runtime in minutes. | |
| min_runtime | No | Minimum runtime in minutes. | |
| with_genres | No | Comma-separated TMDB genre ids (AND); get ids from get_movie_genres/get_tv_genres. | |
| watch_region | No | Country for with_watch_providers, e.g. 'US'. | |
| with_keywords | No | Comma-separated TMDB keyword (use search_keywords to resolve names → ids) ids. | |
| with_networks | No | Comma-separated TMDB TV network, e.g. HBO or Netflix ids. | |
| with_companies | No | Comma-separated TMDB production company ids. | |
| without_genres | No | Comma-separated TMDB genre ids to exclude. | |
| release_date_gte | No | Only entries released on/after this date (YYYY-MM-DD). | |
| release_date_lte | No | Only entries released on/before this date (YYYY-MM-DD). | |
| without_keywords | No | Comma-separated TMDB keyword to exclude ids. | |
| with_watch_providers | No | Comma-separated TMDB watch-provider (e.g. Netflix); requires watch_region ids. | |
| with_original_language | No | ISO-639-1 original-language code, e.g. 'en', 'ja'. |