TMDB Get Discover Tv
1 credits/call
ae_tmdb_get_discover_tv
Find TV shows by filtering and sorting based on criteria like air dates and genres.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Specify which page to query. | 1 |
sort_by | enum (first_air_date.asc | first_air_date.desc | name.asc | name.desc | original_name.asc | original_name.desc | popularity.asc | popularity.desc | vote_average.asc | vote_average.desc | vote_count.asc | vote_count.desc) | No | Choose from one of the many available sort options. | popularity.desc |
language | string | No | Specify a language to query translatable fields with. | en-US |
timezone | string | No | Used in conjunction with the release_type when using with_release_type. Set to something like PST for Pacific Standard Time. | — |
with_type | string | No | Filter results to include only those TV shows with a specific type. Possible values are: [0, 1, 2, 3, 4, 5, 6]. | — |
with_genres | string | No | Filter results to include only those TV shows with specific genres. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'. | — |
with_status | string | No | Filter results to include only those TV shows with a specific status. Possible values are: [0, 1, 2, 3, 4, 5]. | — |
air_date.gte | string | No | Minimum air date. | — |
air_date.lte | string | No | Maximum air date. | — |
watch_region | string | No | An ISO 3166-1 code to filter watch providers. | — |
include_adult | boolean | No | Whether to include adult (pornography) content in the results. | false |
with_keywords | string | No | Filter results to include only those TV shows with specific keywords. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'. | — |
with_networks | integer | No | Filter results to include only those TV shows from specific networks. | — |
vote_count.gte | number | No | Minimum vote count. | — |
vote_count.lte | number | No | Maximum vote count. | — |
with_companies | string | No | Filter results to include only those TV shows produced by specific companies. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'. | — |
without_genres | string | No | Filter results to exclude those TV shows with specific genres. | — |
vote_average.gte | number | No | Minimum vote average. | — |
vote_average.lte | number | No | Maximum vote average. | — |
with_runtime.gte | integer | No | Filter results to include only those TV shows with a runtime greater than or equal to a value. | — |
with_runtime.lte | integer | No | Filter results to include only those TV shows with a runtime less than or equal to a value. | — |
without_keywords | string | No | Filter results to exclude those TV shows with specific keywords. | — |
without_companies | string | No | Filter results to exclude those TV shows produced by specific companies. | — |
first_air_date.gte | string | No | Minimum first air date. | — |
first_air_date.lte | string | No | Maximum first air date. | — |
first_air_date_year | integer | No | Filter by the year of the first air date. | — |
with_origin_country | string | No | Filter results to include only those TV shows with a specific origin country. | — |
with_watch_providers | string | No | Filter results to include only those TV shows with specific watch providers. | — |
screened_theatrically | boolean | No | Filter results to include only those TV shows that have been screened theatrically. | — |
with_original_language | string | No | Filter results to include only those TV shows with a specific original language. | — |
without_watch_providers | string | No | Filter results to exclude those TV shows with specific watch providers. | — |
include_null_first_air_dates | boolean | No | Whether to include shows with null first air dates. | false |
with_watch_monetization_types | string | No | Filter results to include only those TV shows with specific watch monetization types. Possible values are: [flatrate, free, ads, rent, buy]. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tmdb_get_discover_tv' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"include_adult": false,
"include_null_first_air_dates": false,
"language": "en-US",
"page": 1,
"sort_by": "popularity.desc"
}
}'Response exampleresponse.json
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/dyFTt1a9ZpFdKE96kPlE9fQvXOJ.jpg",
"first_air_date": "2017-02-20",
"genre_ids": [
10751
],
"id": 91759,
"origin_country": [
"HK"
]
}
]
}This example shows part of the response. Copied content is valid JSON.

