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": "/2meX1nMdScFOoV4370rqHWKmXhY.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": 8611.964,
      "poster_path": "/dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg",
      "vote_average": 7.8,
      "vote_count": 14486
    },
    {
      "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": 4599.626,
      "poster_path": "/3bzECfllho8PphdYujLUIuhncJD.jpg",
      "vote_average": 5.563,
      "vote_count": 79
    },
    {
      "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": 3513.033,
      "poster_path": "/v7nXPo2zdaIOfeIaERiOuTEt89N.jpg",
      "vote_average": 6.8,
      "vote_count": 86
    },
    {
      "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": 3351.82,
      "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": 3322.43,
      "poster_path": "/30xX4IMbgnMbQwo76xM4BOSokZO.jpg",
      "vote_average": 4.5,
      "vote_count": 9
    },
    {
      "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": 3020.408,
      "poster_path": "/8uDmIxjBx90y5OCwJDBADtQzxb7.jpg",
      "vote_average": 4.429,
      "vote_count": 7
    },
    {
      "adult": false,
      "backdrop_path": null,
      "first_air_date": "2005-09-05",
      "genre_ids": [
        18,
        35
      ],
      "id": 36361,
      "name": "Ulice",
      "origin_country": [
        "CZ"
      ],
      "original_language": "cs",
      "original_name": "Ulice",
      "overview": "Ulice is a Czech soap opera produced and broadcast by Nova. In the Czech language Ulice means street.\n\nThe show describes the lives of the Farský, Jordán, Boháč, Nikl, and Liška families and many other people that live in Prague. Their daily battle against real problems of living in a modern world like divorce, love, betrayal and illness or disease. Ulice often shows crime.",
      "popularity": 2611.223,
      "poster_path": "/gFEHva8Csx18hMGJJZ6gi4sFSKR.jpg",
      "vote_average": 4.6,
      "vote_count": 30
    },
    {
      "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": 2527.344,
      "poster_path": "/7o9eY4qolqVn7SDLZzpJ89t7QYE.jpg",
      "vote_average": 8.2,
      "vote_count": 5
    },
    {
      "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": 2477.511,
      "poster_path": "/nyN8R0P1Hqwq7ksJz4O2BIAUd4W.jpg",
      "vote_average": 6.4,
      "vote_count": 9
    },
    {
      "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": 2466.805,
      "poster_path": "/jFSkjQSZ5Td52igalpoTQRuHtk.jpg",
      "vote_average": 7.9,
      "vote_count": 8
    },
    {
      "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": 2423.893,
      "poster_path": "/6vFL8S6Cci8s7SHWXz60xOisGBC.jpg",
      "vote_average": 7.4,
      "vote_count": 582
    },
    {
      "adult": false,
      "backdrop_path": "/i8iqYtAy9qcO5RSrA1f6fY1n6SN.jpg",
      "first_air_date": "2015-11-16",
      "genre_ids": [
        10766
      ],
      "id": 235484,
      "name": "Suidooster",
      "origin_country": [
        "ZA"
      ],
      "original_language": "af",
      "original_name": "Suidooster",
      "overview": "Suidooster is a South African television soap opera produced by Suidooster Films which revolves around a matriarch, her family, friends and the people of Suidooster, a small shopping and business centre in the fictional Cape Town suburb of Ruiterbosch.",
      "popularity": 2319.123,
      "poster_path": "/naCgSiacvV685kait6fBvhVhdce.jpg",
      "vote_average": 7.7,
      "vote_count": 20
    },
    {
      "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": 2234.99,
      "poster_path": "/ifFpUG51DJaQxwnZ35VwoGRFGGv.jpg",
      "vote_average": 4.813,
      "vote_count": 16
    },
    {
      "adult": false,
      "backdrop_path": "/kkfqNkGQR5og5sDjJTxTVmI9PW.jpg",
      "first_air_date": "2017-07-17",
      "genre_ids": [
        80,
        18
      ],
      "id": 72879,
      "name": "Tomorrow Is Ours",
      "origin_country": [
        "FR"
      ],
      "original_language": "fr",
      "original_name": "Demain nous appartient",
      "overview": "The story revolves around the people of Sète, France. Their lives are punctuated by family rivalries, romance and scenes from daily life, but also by plots involving police investigations, secrets and betrayals.",
      "popularity": 2213.046,
      "poster_path": "/zMWldNZF0wS3L5XkDVFHxYhclcL.jpg",
      "vote_average": 6.3,
      "vote_count": 64
    },
    {
      "adult": false,
      "backdrop_path": "/5w5Cn8c4PNmDA5o9rET2oc0nxwb.jpg",
      "first_air_date": "2024-10-27",
      "genre_ids": [
        18
      ],
      "id": 260695,
      "name": "sensitive chord",
      "origin_country": [
        "EG"
      ],
      "original_language": "ar",
      "original_name": "وتر حساس",
      "overview": "In a social dramatic context, the events of the series revolve around the issue of marital infidelity and the secrets of the human soul through three women (a doctor, a lawyer, and an employee in one of the departments), where the pace of events escalates due to the disputes between the lawyer and her husband, an interior designer, especially after she accused him of betrayal, with the intertwined relationships between all parties.",
      "popularity": 2205.576,
      "poster_path": "/hHoBvznjHhGqPKNkRnqb9zUq8s6.jpg",
      "vote_average": 5.5,
      "vote_count": 2
    },
    {
      "adult": false,
      "backdrop_path": "/s41aHDgGza66JSwEc0poXSuBrmx.jpg",
      "first_air_date": "2024-11-18",
      "genre_ids": [
        18
      ],
      "id": 261121,
      "name": "Desperate Mrs. Seonju",
      "origin_country": [
        "KR"
      ],
      "original_language": "ko",
      "original_name": "친절한 선주씨",
      "overview": "Pi Seon Ju works as an interior designer in a small neighborhood. She is married to Jeon Nam Jin, who is an ambitious architect. Although Pi Seon Ju is devoted to her husband, her husband falls in love with Jin Sang A, who will become the successor of an architecture company. To further pursue his love and ambitions, Jeon Nam Jin demands a divorce from Pi Seon Ju. After their divorce, Pi Seon Ju decides to start her new life.\n\nMeanwhile, architect Kim So U is married to Jin Sang A. Unlike Jin Sang A, he is satisfied with a stable situation rather than being fueled with ambition. Due to his wife's affair with Jeon Nam Jin, Kim So U gets divorced. After meeting Pi Seon Ju, Kim So U experiences a turning point in his life.",
      "popularity": 2179.102,
      "poster_path": "/wALnisqW9vGGJWH1GYUeCCWTcYd.jpg",
      "vote_average": 6.3,
      "vote_count": 3
    },
    {
      "adult": false,
      "backdrop_path": "/2Bkqjc9tNWo3KLr1aRYyJ7vMQtM.jpg",
      "first_air_date": "2023-10-22",
      "genre_ids": [
        10764
      ],
      "id": 235493,
      "name": "De Bondgenoten",
      "origin_country": [
        "NL"
      ],
      "original_language": "nl",
      "original_name": "De Bondgenoten",
      "overview": "",
      "popularity": 2162.016,
      "poster_path": "/sFgeZT3H1Uz3X1OipPq3WONv0WO.jpg",
      "vote_average": 6.8,
      "vote_count": 20
    },
    {
      "adult": false,
      "backdrop_path": "/5APjn4LnV5wWk5DXq7ZewT6zzP1.jpg",
      "first_air_date": "1960-12-09",
      "genre_ids": [
        10766
      ],
      "id": 291,
      "name": "Coronation Street",
      "origin_country": [
        "MY",
        "GB"
      ],
      "original_language": "en",
      "original_name": "Coronation Street",
      "overview": "The residents of Coronation Street are ordinary, working-class people, and the show follows them through regular social and family interactions at home, in the workplace, and in their local pub, the Rovers Return Inn. Britain's longest-running soap.",
      "popularity": 2135.406,
      "poster_path": "/5x1HXqYqPyYw7oc7Isu1lvVmwRP.jpg",
      "vote_average": 5.3,
      "vote_count": 108
    },
    {
      "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": 2097.681,
      "poster_path": "/cRMofv8YC4F1WnpF7cIqMpwSnwh.jpg",
      "vote_average": 5.4,
      "vote_count": 8
    },
    {
      "adult": false,
      "backdrop_path": "/dg2pu4Vm4B2cOqTHlZ26Lka9qEz.jpg",
      "first_air_date": "2024-10-11",
      "genre_ids": [
        10766,
        18
      ],
      "id": 262969,
      "name": "Return to Las Sabinas",
      "origin_country": [
        "ES"
      ],
      "original_language": "es",
      "original_name": "Regreso a Las Sabinas",
      "overview": "Gracia and Paloma return to Las Sabinas to look after their father, Emilio. Gracia reunites with her childhood sweetheart, Miguel, who is now engaged to Esther. Paloma takes over the family's land and clashes with landowner Paca Utrera, who shares a terrible secret with Emilio and has a nefarious plan for the village. Young Óscar is found dead under strange circumstances. Manuela must investigate the murder with the help of Óscar's brother, Álex, who is a priest.",
      "popularity": 2092.241,
      "poster_path": "/xMMH3r8gJtWVe1841BtHGjDooUm.jpg",
      "vote_average": 6.2,
      "vote_count": 5
    }
  ],
  "total_pages": 9439,
  "total_results": 188772
}

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

Selects results with an air date greater than or equal to the specified date.

Example:

""

​
air_date.lte
string

Selects results with an air date less than or equal to the specified date.

Example:

""

​
first_air_date_year
integer

Filters results based on the year of the first air date. Must be a valid four-digit year (e.g., 2020).

Example:

""

​
first_air_date.gte
string

Selects results with a first air date greater than or equal to the specified date.

Example:

""

​
first_air-date.lte
string

Selects results with a first air date less than or equal to the specified date.

Example:

""

​
include_adult
enum<string>

This indicate whether the movie is an adult content.

Example:

false

​
include_null_first_air_dates
enum<string>

Defaults to false. If set to true, includes results that do not have a first air date.

Example:

false

​
language
string

Specifies the language in which the response should be returned.

Example:

"en-US"

​
page
integer

Indicates which page of results to return. Default is the first page (1).

Example:

1

​
screened_theatrically
enum<string>

Filters results to include only those that have been screened in theatres.

Example:

false

​
sorts_by
enum<string>

Defines the order in which results are sorted.

Available options:
orignal_title_asc,
original_title_desc,
popularity_asc,
popularity_desc,
revenue_asc,
revenue_desc,
prirmary_release_date.asc,
title_asc,
title_desc,
primary_release_date.desc,
vote_average.asc,
vote_average_desc,
vote_count.asc,
vote_count.desc
Example:

"popularity_desc"

​
timezone
string

Specifies the timezone for date-related queries.

Example:

""

​
vote_average.gte
number

Filters results to include those with an average vote greater than or equal to the specified value.

Example:

""

​
vote_average.lte
number

Filters results to include those with an average vote less than or equal to the specified value.

Example:

""

​
vote_count.gte
number

Filters results to include those with a vote count greater than or equal to the specified number.

Example:

""

​
vote_count.lte
number

Filters results to include those with a vote count less than or equal to the specified number.

Example:

""

​
watch_region
string

Specifies a region code for filtering results based on available watch providers or monetization types.

Example:

""

​
with_companies
string

Filters results to include films produced by specific companies. Can also be a comma (for AND) or pipe (for OR) separated query.

Example:

""

​
with_genres
string

string Filters results by specified genres (e.g., action, comedy). Can be a comma (for AND) or pipe (for OR) separated query.

Example:

""

​
with_keyword
string

Filters results to include films associated with specific keywords. Can be a comma (for AND) or pipe (for OR) separated query.

Example:

""

​
with_networks
string

Filters results to include those on specified networks (e.g., NBC, HBO).

Example:

""

​
with_origin_country
string

Filters results based on the country of origin of the film.

Example:

""

​
with_original_language
string

Filters results to include films in a specified original language.

Example:

""

​
with-runtime.gte
integer

Filters results to include films with a runtime greater than or equal to the specified number of minutes.

Example:

""

​
with_runtime.lte
integer

Filters results to include films with a runtime less than or equal to the specified number of minutes.

Example:

""

​
with_status
string

Possible values are [0, 1, 2, 3, 4, 5]. Can be a comma (AND) or pipe (OR) separated query to filter results based on content status (e.g., air/ended).

Example:

""

​
with_watch_monetization
string

Filters results based on financial aspects of watching, including types like "flatrate," "free," "ads," "rent," or "buy."

Example:

""

​
with_watch_providers
string

Specifies which watch providers to filter by, such as Netflix or Hulu. Can be a comma (for AND) or pipe (for OR) separated query.

Example:

""

​
without_companies
string

results to exclude specified genres from the results.

Example:

""

​
without_keywords
string

Filters results to exclude specified keywords associated with the films.

Example:

""

​
without_watch_providers
string

Filters results to exclude films available on specified watch providers.

Example:

""

​
with_type
string

Possible values are [0, 1, 2, 3, 4, 5, 6]. Can be a comma (AND) or pipe (OR) separated query to filter results by type (e.g., movie, series).

Example:

""

Response

200 - application/json
tv

The response is of type object.