discover_tv
Find TV shows using advanced filters for language, genres, air dates, networks, ratings, and streaming providers to support AI content curation.
Instructions
Performs advanced discovery of TV shows with extensive filtering options. Input: Optional parameters including language (ISO 639-1), sort_by, air dates, genres, networks, keywords, watch providers, vote counts, etc. Output: JSON with paginated results. Purpose: Enable complex, criteria-based TV show discovery for AI-driven content curation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| air_date.gte | No | Air date from (YYYY-MM-DD) | |
| air_date.lte | No | Air date to (YYYY-MM-DD) | |
| first_air_date.gte | No | First air date from (YYYY-MM-DD) | |
| first_air_date.lte | No | First air date to (YYYY-MM-DD) | |
| first_air_date_year | No | First air date year | |
| include_null_first_air_dates | No | Include shows with null first air dates | |
| language | No | ISO 639-1 language (e.g., en-US) | |
| page | No | Page number (1-500) | |
| screened_theatrically | No | Not applicable to TV but accepted safely | |
| sort_by | No | Sort by (e.g., popularity.desc, first_air_date.desc, vote_average.desc) | |
| timezone | No | Timezone for air date lookups (e.g., America/New_York) | |
| vote_average.gte | No | Minimum vote average | |
| vote_average.lte | No | Maximum vote average | |
| vote_count.gte | No | Minimum vote count | |
| vote_count.lte | No | Maximum vote count | |
| watch_region | No | ISO 3166-1 region for watch providers | |
| with_companies | No | Comma-separated company IDs | |
| with_genres | No | Comma-separated genre IDs | |
| with_keywords | No | Comma-separated keyword IDs | |
| with_name_translation | No | ISO 639-1 language to filter by available translations | |
| with_networks | No | Comma-separated network IDs | |
| with_original_language | No | Original language (ISO 639-1) | |
| with_overview_translation | No | ISO 639-1 language to filter overview translations | |
| with_runtime.gte | No | Runtime min (minutes) | |
| with_runtime.lte | No | Runtime max (minutes) | |
| with_status | No | Comma-separated production status (Returning Series|Planned|In Production|Ended|Canceled|Pilot) | |
| with_type | No | Comma-separated TV types (e.g., Documentary, News) | |
| with_watch_monetization_types | No | Comma-separated monetization types (flatrate|free|ads|rent|buy) | |
| with_watch_providers | No | Comma-separated watch provider IDs | |
| without_genres | No | Comma-separated genre IDs to exclude | |
| without_keywords | No | Comma-separated keyword IDs to exclude |
Input Schema (JSON Schema)
{
"properties": {
"air_date.gte": {
"description": "Air date from (YYYY-MM-DD)",
"type": "string"
},
"air_date.lte": {
"description": "Air date to (YYYY-MM-DD)",
"type": "string"
},
"first_air_date.gte": {
"description": "First air date from (YYYY-MM-DD)",
"type": "string"
},
"first_air_date.lte": {
"description": "First air date to (YYYY-MM-DD)",
"type": "string"
},
"first_air_date_year": {
"description": "First air date year",
"type": "number"
},
"include_null_first_air_dates": {
"description": "Include shows with null first air dates",
"type": "boolean"
},
"language": {
"description": "ISO 639-1 language (e.g., en-US)",
"type": "string"
},
"page": {
"description": "Page number (1-500)",
"minimum": 1,
"type": "number"
},
"screened_theatrically": {
"description": "Not applicable to TV but accepted safely",
"type": "boolean"
},
"sort_by": {
"description": "Sort by (e.g., popularity.desc, first_air_date.desc, vote_average.desc)",
"type": "string"
},
"timezone": {
"description": "Timezone for air date lookups (e.g., America/New_York)",
"type": "string"
},
"vote_average.gte": {
"description": "Minimum vote average",
"type": "number"
},
"vote_average.lte": {
"description": "Maximum vote average",
"type": "number"
},
"vote_count.gte": {
"description": "Minimum vote count",
"type": "number"
},
"vote_count.lte": {
"description": "Maximum vote count",
"type": "number"
},
"watch_region": {
"description": "ISO 3166-1 region for watch providers",
"type": "string"
},
"with_companies": {
"description": "Comma-separated company IDs",
"type": "string"
},
"with_genres": {
"description": "Comma-separated genre IDs",
"type": "string"
},
"with_keywords": {
"description": "Comma-separated keyword IDs",
"type": "string"
},
"with_name_translation": {
"description": "ISO 639-1 language to filter by available translations",
"type": "string"
},
"with_networks": {
"description": "Comma-separated network IDs",
"type": "string"
},
"with_original_language": {
"description": "Original language (ISO 639-1)",
"type": "string"
},
"with_overview_translation": {
"description": "ISO 639-1 language to filter overview translations",
"type": "string"
},
"with_runtime.gte": {
"description": "Runtime min (minutes)",
"type": "number"
},
"with_runtime.lte": {
"description": "Runtime max (minutes)",
"type": "number"
},
"with_status": {
"description": "Comma-separated production status (Returning Series|Planned|In Production|Ended|Canceled|Pilot)",
"type": "string"
},
"with_type": {
"description": "Comma-separated TV types (e.g., Documentary, News)",
"type": "string"
},
"with_watch_monetization_types": {
"description": "Comma-separated monetization types (flatrate|free|ads|rent|buy)",
"type": "string"
},
"with_watch_providers": {
"description": "Comma-separated watch provider IDs",
"type": "string"
},
"without_genres": {
"description": "Comma-separated genre IDs to exclude",
"type": "string"
},
"without_keywords": {
"description": "Comma-separated keyword IDs to exclude",
"type": "string"
}
},
"type": "object"
}