TV

get https://api.themoviedb.org/3/discover/tv

Find TV shows using over 30 filters and sort options.

Advanced Filtering

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It's important to note the order of the release types that are used. Specifying 2|3 would return the limited theatrical release date as opposed to 3|2 which would return the theatrical date.

`AND`/`OR` Logic

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma's are treated like an AND query while pipe's are treated like an OR. This allows for quite complex filtering depending on your desired results.

Query Params

air_date.gte

date

air_date.lte

date

first_air_date_year

int32

first_air_date.gte

date

first_air_date.lte

date

include_adult

boolean

Defaults to false

include_null_first_air_dates

boolean

Defaults to false

language

string

Defaults to en-US

page

int32

Defaults to 1

screened_theatrically

boolean

sort_by

string

Defaults to popularity.desc

timezone

string

vote_average.gte

float

vote_average.lte

float

vote_count.gte

float

vote_count.lte

float

watch_region

string

use in conjunction with with_watch_monetization_types or with_watch_providers

with_companies

string

can be a comma (AND) or pipe (OR) separated query

with_genres

string

can be a comma (AND) or pipe (OR) separated query

with_keywords

string

can be a comma (AND) or pipe (OR) separated query

with_networks

int32

with_origin_country

string

with_original_language

string

with_runtime.gte

int32

with_runtime.lte

int32

with_status

string

possible values are: [0, 1, 2, 3, 4, 5], can be a comma (AND) or pipe (OR) separated query

with_watch_monetization_types

string

possible values are: [flatrate, free, ads, rent, buy] use in conjunction with watch_region, can be a comma (AND) or pipe (OR) separated query

with_watch_providers

string

use in conjunction with watch_region, can be a comma (AND) or pipe (OR) separated query

without_companies

string

without_genres

string

without_keywords

string

without_watch_providers

string

with_type

string

possible values are: [0, 1, 2, 3, 4, 5, 6], can be a comma (AND) or pipe (OR) separated query

Response

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.themoviedb.org/3/discover/tv?include_adult=false&include_null_first_air_dates=false&language=en-US&page=1&sort_by=popularity.desc' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Advanced Filtering

AND/OR Logic

200200

`AND`/`OR` Logic