Sign in

v1

latestOpenAPI 3.1.02026-07-24270489.8 KB

TV

Find TV shows using over 30 filters and sort options.

get/3/discover/tv

Query parameters

air_date.gtestring date
air_date.ltestring date
first_air_date_yearinteger
first_air_date.gtestring date
first_air_date.ltestring date
include_adultboolean
include_null_first_air_datesboolean
languagestring
pageinteger
screened_theatricallyboolean
sort_by'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'
timezonestring
vote_average.gtenumber float
vote_average.ltenumber float
vote_count.gtenumber float
vote_count.ltenumber float
watch_regionstring

use in conjunction with with_watch_monetization_types or with_watch_providers

with_companiesstring

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

with_genresstring

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

with_keywordsstring

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

with_networksinteger
with_origin_countrystring
with_original_languagestring
with_runtime.gteinteger
with_runtime.lteinteger
with_statusstring

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

with_watch_monetization_typesstring

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_providersstring

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

without_companiesstring
without_genresstring
without_keywordsstring
without_watch_providersstring
with_typestring

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

Response

200

pageinteger
total_pagesinteger
total_resultsinteger

Example response

{
  "page": 1,
  "results": [
    {
      "backdrop_path": "/mAJ84W6I8I272Da87qplS2Dp9ST.jpg",
      "first_air_date": "2023-01-23",
      "genre_ids": [
        9648
      ],
      "id": 202250,
      "name": "Dirty Linen",
      "origin_country": [
        "PH"
      ],
      "original_language": "tl",
      "original_name": "Dirty Linen",
      "overview": "To exact vengeance, a young woman infiltrates the household of an influential family as a housemaid to expose their dirty secrets. However, love will get in the way of her revenge plot.",
      "popularity": 2684.061,
      "poster_path": "/ujlkQtHAVShWyWTloGU2Vh5Jbo9.jpg",
      "vote_average": 5,
      "vote_count": 13
    }
  ],
  "total_pages": 7414,
  "total_results": 148265
}