Discover Method: TV

Name

Type

Category

Description

language

string

optional

This is an ISO_3166_1 code used to get the translated data as per the specified language. This is applicable to only the fields that support it. The default value is en-US.

sort_by

string

optional

This is used to specify the type of sort we want in our search results. The valid values include popularity.asc, popularity.desc, vote_average.asc, vote_average.desc, first_air_date.desc, and first_air_date.asc.

first_air_date_year

integer

optional

This filters and only includes TV shows with an original air date year equal to the specified value. We can use it in conjunction with the include_null_first_air_dates filter if we want to include items with no air date.

with_genres

string

optional

This is a comma-separated value of genre IDs that we want to include in the results.

with_watch_providers

string

optional

This is a comma or pipe separated list of watch provider IDs. We can combine this filter with watch_region in order to filter our results by a specific watch provider in a specific region.

screened_theatrically

boolean

optional

This is used to filter results to include items that have been screened theatrically.

with_status

string

optional

This is used to filter TV shows by their status. The valid value for Returning Series is 0, Planned is 1, In Production is 2, Ended is 3, Canceled is 4, and Pilot is 5.

with_type

string

optional

This is used to filter TV shows by their type. The valid value for Documentary is 0, News is 1, Miniseries is 2, Reality is 3, Scripted is 4, Talk Show is 5, and Video is 6.