GET
/
3
/
discover
/
tv
curl --request GET \
  --url https://api.themoviedb.org/3/discover/tv \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/ukAmSyNdtWduHZfm27R2EOsguKt.jpg",
      "first_air_date": "2021-09-17",
      "genre_ids": [
        10759,
        9648,
        18
      ],
      "id": 93405,
      "name": "Squid Game",
      "origin_country": [
        "KR"
      ],
      "original_language": "ko",
      "original_name": "오징어 게임",
      "overview": "Hundreds of cash-strapped players accept a strange invitation to compete in children's games. Inside, a tempting prize awaits — with deadly high stakes.",
      "popularity": 10243.452,
      "poster_path": "/dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg",
      "vote_average": 7.8,
      "vote_count": 14748
    },
    {
      "adult": false,
      "backdrop_path": "/mu3lEhGovyhKHPJzb7HNYtZUCDT.jpg",
      "first_air_date": "2005-10-13",
      "genre_ids": [
        10766
      ],
      "id": 206559,
      "name": "Binnelanders",
      "origin_country": [
        "ZA"
      ],
      "original_language": "af",
      "original_name": "Binnelanders",
      "overview": "A South African Afrikaans soap opera. It is set in and around the fictional private hospital, Binneland Kliniek, in Pretoria, and the storyline follows the trials, trauma and tribulations of the staff and patients of the hospital.",
      "popularity": 4523.67,
      "poster_path": "/3bzECfllho8PphdYujLUIuhncJD.jpg",
      "vote_average": 5.6,
      "vote_count": 80
    },
    {
      "adult": false,
      "backdrop_path": "/2wNuLc0cEoPz6PZItftrZLHjG2k.jpg",
      "first_air_date": "2024-10-27",
      "genre_ids": [
        18,
        10751
      ],
      "id": 251691,
      "name": "Autumn of the Heart",
      "origin_country": [
        "SA"
      ],
      "original_language": "ar",
      "original_name": "خريف القلب",
      "overview": "A devastating car accident unearths a long-buried secret that turns wealthy businessman Rashid and hardworking Nahla's life around; fifteen years ago, their daughters were switched at birth.",
      "popularity": 3136.985,
      "poster_path": "/8uDmIxjBx90y5OCwJDBADtQzxb7.jpg",
      "vote_average": 4.2,
      "vote_count": 9
    },
    {
      "adult": false,
      "backdrop_path": "/fRzSn59mtc4BV3cckdHntRKaufM.jpg",
      "first_air_date": "2012-05-14",
      "genre_ids": [
        35,
        18,
        10751
      ],
      "id": 84791,
      "name": "Come Home Love",
      "origin_country": [
        "HK"
      ],
      "original_language": "cn",
      "original_name": "愛·回家",
      "overview": "MA FU, a retired employee of the HK Correctional Services Department, moved back to live with his son after retirement. MA FU treats and disciplines everyone in his family as if they were the offenders he works with in his job. His youngest son MA CHONG feels like he's in jail when he gets home, and his father is even often involved with his job as a paralegal. The father and son get into disputes daily and his elder brother MA KEUNG and his wife LO LAI SEUNG are often stuck in between and have to settle the disputes. The couple also holds the heavy responsibility of raising their kids. Three generations in the MA family all live together and encounter different situations, experiences and system of values.",
      "popularity": 2802.18,
      "poster_path": "/nQwKCmgbpjb3wIf816t4WNgxzcR.jpg",
      "vote_average": 8,
      "vote_count": 1
    },
    {
      "adult": false,
      "backdrop_path": "/j5CR0gFPjwgmAXkV9HGaF4VMjIW.jpg",
      "first_air_date": "2024-09-30",
      "genre_ids": [
        10766,
        18,
        35
      ],
      "id": 257064,
      "name": "Volta por Cima",
      "origin_country": [
        "BR"
      ],
      "original_language": "pt",
      "original_name": "Volta por Cima",
      "overview": "",
      "popularity": 2590.577,
      "poster_path": "/nyN8R0P1Hqwq7ksJz4O2BIAUd4W.jpg",
      "vote_average": 6.4,
      "vote_count": 9
    },
    {
      "adult": false,
      "backdrop_path": "/sztoil0XfQ0cSHy4PXmYW6uAdfQ.jpg",
      "first_air_date": "2013-03-22",
      "genre_ids": [
        10764
      ],
      "id": 65282,
      "name": "Home Alone",
      "origin_country": [
        "KR",
        "US"
      ],
      "original_language": "ko",
      "original_name": "나 혼자 산다",
      "overview": "It can be a badge of honor to be “single.” “I Live Alone” is a documentary-style South Korean reality series that follows the members of a self-formed club called Rainbow, which is comprised of  celebrities who are single and live alone.",
      "popularity": 2605.341,
      "poster_path": "/1hqGagr94soBq70Lq7tPHvNmmxy.jpg",
      "vote_average": 6.8,
      "vote_count": 16
    },
    {
      "adult": false,
      "backdrop_path": "/tPLUHT2cQYJi66aSZZ1qrcu74Zq.jpg",
      "first_air_date": "2024-11-04",
      "genre_ids": [
        10766,
        18
      ],
      "id": 257048,
      "name": "Garota do Momento",
      "origin_country": [
        "BR"
      ],
      "original_language": "pt",
      "original_name": "Garota do Momento",
      "overview": "",
      "popularity": 2542.957,
      "poster_path": "/jFSkjQSZ5Td52igalpoTQRuHtk.jpg",
      "vote_average": 8.111,
      "vote_count": 9
    },
    {
      "adult": false,
      "backdrop_path": "/4i3iJepkqqH5JJgTNLJdi8ke6ir.jpg",
      "first_air_date": "2024-05-06",
      "genre_ids": [
        10766
      ],
      "id": 249010,
      "name": "Kelders van Geheime",
      "origin_country": [
        "ZA"
      ],
      "original_language": "af",
      "original_name": "Kelders van Geheime",
      "overview": "Kelders van Geheime (Cellars of Secrets) is a South African, Afrikaans-language telenovela based on the wheeling's and dealings of the community that lives on Soebatskloof (a wine farm in the Cape). The series focuses on three families: the Abrahams, Syster and Marais households. These families will have to stand together, agree (or agree to disagree), and work together to earn their bread and butter – and a glass of wine.",
      "popularity": 3271.698,
      "poster_path": "/vf1I0G5jICTstI1EXxb9Oqq80TU.jpg",
      "vote_average": 5.9,
      "vote_count": 13
    },
    {
      "adult": false,
      "backdrop_path": "/mLcD1v4sfoa1juOsBat7Vik7wEe.jpg",
      "first_air_date": "2024-03-18",
      "genre_ids": [
        10764
      ],
      "id": 248890,
      "name": "Ready Steady Cook South Africa",
      "origin_country": [
        "ZA"
      ],
      "original_language": "en",
      "original_name": "Ready Steady Cook South Africa",
      "overview": "In Ready Steady Cook, two teams - a Red Tomato and a Green Pepper - compete in a Red Kitchen and a Green Kitchen, together with a South African chef on each side and paired with enthusiastic home cooks, as they are challenged creatively with a mystery bag of ingredients in a 20-minute cook-off.",
      "popularity": 1787.666,
      "poster_path": "/30xX4IMbgnMbQwo76xM4BOSokZO.jpg",
      "vote_average": 4.5,
      "vote_count": 9
    },
    {
      "adult": false,
      "backdrop_path": "/1xlpfYGGFXOlYqQSUlFKEv4hqbt.jpg",
      "first_air_date": "2002-10-21",
      "genre_ids": [
        10759,
        16,
        10765,
        10762
      ],
      "id": 46392,
      "name": "Duel Masters",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "デュエル・マスターズ",
      "overview": "A mysterious organization is interested in fledging duelist Shobu Kirifuda's ability to bring Duel Master creatures to life. With the support of his friends, Shobu duels with passion, discipline, and heart as he strives to be like his father and become the next Kaijudo master.",
      "popularity": 2934.35,
      "poster_path": "/t5ijeKzOukACRktUfbjuMIlqwfr.jpg",
      "vote_average": 5.9,
      "vote_count": 14
    },
    {
      "adult": false,
      "backdrop_path": "/4uWvmON2pqDJtpPAsHMggdDFFrn.jpg",
      "first_air_date": "1990-09-13",
      "genre_ids": [
        80,
        18
      ],
      "id": 549,
      "name": "Law & Order",
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "Law & Order",
      "overview": "In cases ripped from the headlines, police investigate serious and often deadly crimes, weighing the evidence and questioning the suspects until someone is taken into custody. The district attorney's office then builds a case to convict the perpetrator by proving the person guilty beyond a reasonable doubt. Working together, these expert teams navigate all sides of the complex criminal justice system to make New York a safer place.",
      "popularity": 1940.524,
      "poster_path": "/6vFL8S6Cci8s7SHWXz60xOisGBC.jpg",
      "vote_average": 7.4,
      "vote_count": 584
    },
    {
      "adult": false,
      "backdrop_path": "/9zIqN0oMmaeFvBlccgw80sWed7I.jpg",
      "first_air_date": "2007-09-10",
      "genre_ids": [
        10763,
        35
      ],
      "id": 13008,
      "name": "TMZ",
      "origin_country": [
        "US"
      ],
      "original_language": "en",
      "original_name": "TMZ",
      "overview": "Based on the popular gossip website, this entertainment newsmagazine delivers daily updates on Hollywood's rich, beautiful and screwed-up. The program often shows highlights of the day's staff meeting during which reporters pitch ideas for stories to air that day.",
      "popularity": 2314.097,
      "poster_path": "/ifFpUG51DJaQxwnZ35VwoGRFGGv.jpg",
      "vote_average": 4.813,
      "vote_count": 16
    },
    {
      "adult": false,
      "backdrop_path": "/n85GMdNw2pDVtkgoTdpHNpM89Uh.jpg",
      "first_air_date": "2011-12-18",
      "genre_ids": [
        18
      ],
      "id": 42316,
      "name": "Devon Ke Dev...Mahadev",
      "origin_country": [
        "IO"
      ],
      "original_language": "hi",
      "original_name": "देवों के देव...महादेव",
      "overview": "He is the supreme being and the destroyer of evil. Witness lord Shiva's story, his avatars, and a union that sha more.",
      "popularity": 2195.379,
      "poster_path": "/oMzXcYsUVIt6pQEODc6FRe8IBug.jpg",
      "vote_average": 9.1,
      "vote_count": 7
    },
    {
      "adult": false,
      "backdrop_path": "/6wAu4kZiKov5WkavL7H2ZfwbGAo.jpg",
      "first_air_date": "2024-09-09",
      "genre_ids": [
        10766,
        18,
        9648
      ],
      "id": 237478,
      "name": "Crazy About You",
      "origin_country": [
        "BR"
      ],
      "original_language": "pt",
      "original_name": "Mania de Você",
      "overview": "The story begins with the ambiguous relationship between friends Viola and Luma, who seem predestined to literally enter each other's lives. Born on the same day, in very different situations, they meet years later, united by coincidences that go beyond their birthday. From humble origins, Viola moves with her boyfriend Mavi to Angra dos Reis, where Luma lives a luxurious life and dates Rudá, who ends up meeting Viola by chance. Thus begins the duo's journey, which goes from a passion for recipes to an obsession with the same man, from the immediate connection to the point of starting to live their friend’s reality, 10 years later. A journey divided between complicity and rivalry, which includes them in a love quadrangle and is impacted by a series of circumstances, twists and surprises, such as the secret surrounding a murder.",
      "popularity": 2187.073,
      "poster_path": "/cRMofv8YC4F1WnpF7cIqMpwSnwh.jpg",
      "vote_average": 5.2,
      "vote_count": 10
    },
    {
      "adult": false,
      "backdrop_path": "/xpVVR4gfM8P9uW1JUPg1NMAWqLn.jpg",
      "first_air_date": "2016-10-12",
      "genre_ids": [
        10764,
        35
      ],
      "id": 96804,
      "name": "LOONA TV",
      "origin_country": [
        "KR"
      ],
      "original_language": "ko",
      "original_name": "이달의소녀탐구",
      "overview": "LOONA TV (이달의 소녀 탐구, Girl of the Month Inquiry) are short videos featuring the members of LOOΠΔ during their travels, behind the scenes of jacket shootings and the sets of music video filming, and even their off-time interactions as they have fun.",
      "popularity": 2282.353,
      "poster_path": "/i4afg3YM6wfdDsNjK95pIO2MAUR.jpg",
      "vote_average": 7,
      "vote_count": 3
    },
    {
      "adult": false,
      "backdrop_path": "/vgeDRVpSUa4Hvovg4C6dgm4dfUW.jpg",
      "first_air_date": "2020-11-02",
      "genre_ids": [
        10766,
        18
      ],
      "id": 112470,
      "name": "Ici tout commence",
      "origin_country": [
        "FR"
      ],
      "original_language": "fr",
      "original_name": "Ici tout commence",
      "overview": "This television drama series is centered around the prestigious culinary school of renowned chef Auguste Armand. The show follows the lives of students and staff as they navigate the challenges and pressures of the culinary world—delving into their personal and professional lives, revealing secrets, rivalries, and complex relationships.",
      "popularity": 1938.254,
      "poster_path": "/v7nXPo2zdaIOfeIaERiOuTEt89N.jpg",
      "vote_average": 6.8,
      "vote_count": 86
    },
    {
      "adult": false,
      "backdrop_path": "/vFJpFtQsYs6jY1CrAESGneVVI3o.jpg",
      "first_air_date": "2024-11-11",
      "genre_ids": [
        18
      ],
      "id": 273327,
      "name": "Black Point",
      "origin_country": [
        "EG"
      ],
      "original_language": "ar",
      "original_name": "نقطة سودة",
      "overview": "“Black Point” takes place in a social romantic setting, exploring the complex relationships between its diverse characters.",
      "popularity": 1985.25,
      "poster_path": "/xrGx7uRbCc9qwU76YD2wJXL56Js.jpg",
      "vote_average": 1,
      "vote_count": 1
    },
    {
      "adult": false,
      "backdrop_path": "/xSQaQi0WfPPmJ9UAFGIUkBciwns.jpg",
      "first_air_date": "2015-04-20",
      "genre_ids": [
        10767
      ],
      "id": 96386,
      "name": "Nogizaka Under Construction",
      "origin_country": [
        "JP"
      ],
      "original_language": "ja",
      "original_name": "乃木坂工事中",
      "overview": "Nogizaka46 is making a big leap forward right now!\n\nTheir activities range from live performances, varieties, dramas, movies, and models.\n\nIn order to give these girls even more momentum, this program will challenge various projects that bring out new aspects and charms of the members!!!",
      "popularity": 1804.085,
      "poster_path": "/wjfGdo9BoKeakiSxdKdiPZxv1jA.jpg",
      "vote_average": 8.2,
      "vote_count": 4
    },
    {
      "adult": false,
      "backdrop_path": "/zk3UqXnnK7cpUv6LsD9DS8FtUxb.jpg",
      "first_air_date": "2024-09-02",
      "genre_ids": [
        18,
        10759
      ],
      "id": 256121,
      "name": "Lavender Fields",
      "origin_country": [
        "PH"
      ],
      "original_language": "tl",
      "original_name": "Lavender Fields",
      "overview": "The life of a simple flower farm girl is shattered when she falls for a charming accountant, who turns out to be a married gun cartel member. Targeted for his stolen money, she loses everything she holds dear and reinvents herself to seek justice.",
      "popularity": 2518.095,
      "poster_path": "/7o9eY4qolqVn7SDLZzpJ89t7QYE.jpg",
      "vote_average": 7.2,
      "vote_count": 6
    },
    {
      "adult": false,
      "backdrop_path": "/mP0LywGWY77Qa9rmfWZPJDEGaY2.jpg",
      "first_air_date": "2018-10-01",
      "genre_ids": [
        18,
        10751,
        35,
        10759,
        10766
      ],
      "id": 86310,
      "name": "RadhaKrishn",
      "origin_country": [
        "IN"
      ],
      "original_language": "hi",
      "original_name": "राधाकृष्ण",
      "overview": "The story of Radha and Krishna is the epitome of eternal love, which transcends eras and emotions.",
      "popularity": 2408.855,
      "poster_path": "/3SiMmfY0663JmjpAfftmj1h6XGP.jpg",
      "vote_average": 9,
      "vote_count": 4
    }
  ],
  "total_pages": 9456,
  "total_results": 189114
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
air_date.gte
string

Filters results to include only those with an air date on or after the specified date (YYYY-MM-DD).

​
air_date.lte
string

Filters results to include only those with an air date on or before the specified date (YYYY-MM-DD).

​
first_air_date_year
integer

Filters results to include only those with a first air date matching the specified year (YYYY).

​
first_air_date.gte
string

Filters results to include only those with a first air date on or after the specified date (YYYY-MM-DD).

​
first_air_date.lte
string

Filters results to include only those with a first air date on or before the specified date (YYYY-MM-DD).

​
include_adult
boolean

Whether to include adult content (true) or exclude it (false).

Example:

false

​
include_null_first_air_dates
boolean

Whether to include TV shows with missing first air dates.

Example:

false

​
language
string
default:en-US

The language of the results, formatted as an ISO 639-1 code (e.g., en-US).

​
page
integer
default:1

The page number of results to retrieve (for pagination).

​
screened_theatrically
boolean

Whether the movie was screened theatrically.

​
sort_by
enum<string>

Sorting criteria for results (e.g., popularity, vote count, first air date).

Available options:
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
​
timezone
string

The timezone for date-related queries (e.g., America/New_York).

​
vote_average.gte
number

Minimum vote average for filtering results.

​
vote_average.lte
number

Maximum vote average for filtering results.

​
vote_count.gte
number

Minimum number of votes a movie or show must have to be included in the results.

​
vote_count.lte
number

Maximum number of votes a movie or show can have to be included in the results.

​
watch_region
string

The country code (ISO 3166-1) to filter available streaming content.

​
with_companies
string

Filter by production companies (comma , for AND, pipe | for OR).

​
with_genres
string

Filter by genre IDs (comma , for AND, pipe | for OR).

​
with_keywords
string

Filter by keywords (comma , for AND, pipe | for OR).

​
with_networks
integer

Filter by network ID (e.g., Netflix, HBO).

​
with_origin_country
string

Filter by the original country of production (ISO 3166-1 code).

​
with_original_language
string

Filter by the original language of the content (ISO 639-1 code).

​
with_runtime.gte
integer

Minimum runtime (in minutes) for filtering results.

​
with_runtime.lte
integer

Maximum runtime (in minutes) for filtering results.

​
with_status
string

Filter by status (possible values- 0, 1, 2, 3, 4, 5) using comma , (AND) or pipe | (OR).

​
with_watch_monetization
string

Filter by monetization type (possible values- flatrate, free, ads, rent, buy). Use in conjunction with watch_region.

​
with_watch_providers
string

Filter by streaming providers. Use with watch_region.

​
without_companies
string

Exclude content from specific production companies.

​
without_genres
string

Exclude content with specific genre IDs.

​
without_keywords
string

Exclude content with specific keywords.

​
without_watch_providers
string

Exclude content from specific streaming providers.

​
with_type
string

Filter by type (possible values- 0, 1, 2, 3, 4, 5) using comma , (AND) or pipe | (OR).

Response

200 - application/json

TV

The response is of type object.