GET
/
3
/
discover
/
movie
curl --request GET \
  --url https://api.themoviedb.org/3/discover/movie \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/euYIwmwkmz95mnXvufEmbL6ovhZ.jpg",
      "genre_ids": [
        28,
        12,
        18
      ],
      "id": 558449,
      "original_language": "en",
      "original_title": "Gladiator II",
      "overview": "Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people.",
      "popularity": 4584.535,
      "poster_path": "/2cxhvwyEwRlysAmRH4iodkvo0z5.jpg",
      "release_date": "2024-11-05",
      "title": "Gladiator II",
      "video": false,
      "vote_average": 6.771,
      "vote_count": 2087
    },
    {
      "adult": false,
      "backdrop_path": "/zOpe0eHsq0A2NvNyBbtT6sj53qV.jpg",
      "genre_ids": [
        28,
        878,
        35,
        10751
      ],
      "id": 939243,
      "original_language": "en",
      "original_title": "Sonic the Hedgehog 3",
      "overview": "Sonic, Knuckles, and Tails reunite against a powerful new adversary, Shadow, a mysterious villain with powers unlike anything they have faced before. With their abilities outmatched in every way, Team Sonic must seek out an unlikely alliance in hopes of stopping Shadow and protecting the planet.",
      "popularity": 3668.314,
      "poster_path": "/x7NPbBlrvFRJrpinBSRlMOOUWom.jpg",
      "release_date": "2024-12-19",
      "title": "Sonic the Hedgehog 3",
      "video": false,
      "vote_average": 7.7,
      "vote_count": 380
    },
    {
      "adult": false,
      "backdrop_path": "/k24eZq5I3jyz4htPkZCRpnUmBzE.jpg",
      "genre_ids": [
        10749,
        18
      ],
      "id": 1156593,
      "original_language": "es",
      "original_title": "Culpa tuya",
      "overview": "The love between Noah and Nick seems unwavering despite their parents' attempts to separate them. But his job and her entry into college open up their lives to new relationships that will shake the foundations of both their relationship and the Leister family itself.",
      "popularity": 3327.447,
      "poster_path": "/1sQA7lfcF9yUyoLYC0e6Zo3jmxE.jpg",
      "release_date": "2024-12-26",
      "title": "Your Fault",
      "video": false,
      "vote_average": 7.1,
      "vote_count": 720
    },
    {
      "adult": false,
      "backdrop_path": "/oHPoF0Gzu8xwK4CtdXDaWdcuZxZ.jpg",
      "genre_ids": [
        12,
        10751,
        16
      ],
      "id": 762509,
      "original_language": "en",
      "original_title": "Mufasa: The Lion King",
      "overview": "Mufasa, a cub lost and alone, meets a sympathetic lion named Taka, the heir to a royal bloodline. The chance meeting sets in motion an expansive journey of a group of misfits searching for their destiny.",
      "popularity": 2975.426,
      "poster_path": "/nHhjqeJcaQKOBCd21c1kV2DK5gm.jpg",
      "release_date": "2024-12-18",
      "title": "Mufasa: The Lion King",
      "video": false,
      "vote_average": 7.446,
      "vote_count": 491
    },
    {
      "adult": false,
      "backdrop_path": "/vZG7PrX9HmdgL5qfZRjhJsFYEIA.jpg",
      "genre_ids": [
        28,
        878,
        12
      ],
      "id": 912649,
      "original_language": "en",
      "original_title": "Venom: The Last Dance",
      "overview": "Eddie and Venom are on the run. Hunted by both of their worlds and with the net closing in, the duo are forced into a devastating decision that will bring the curtains down on Venom and Eddie's last dance.",
      "popularity": 2805.136,
      "poster_path": "/aosm8NMQ3UyoBVpSxyimorCQykC.jpg",
      "release_date": "2024-10-22",
      "title": "Venom: The Last Dance",
      "video": false,
      "vote_average": 6.81,
      "vote_count": 2184
    },
    {
      "adult": false,
      "backdrop_path": "/A6vAMO3myroRfBwSZetY4GVqaW4.jpg",
      "genre_ids": [
        16,
        14,
        28,
        12
      ],
      "id": 839033,
      "original_language": "en",
      "original_title": "The Lord of the Rings: The War of the Rohirrim",
      "overview": "183 years before the events chronicled in the original trilogy, a sudden attack by Wulf, a clever and ruthless Dunlending lord seeking vengeance for the death of his father, forces Helm Hammerhand and his people to make a daring last stand in the ancient stronghold of the Hornburg. Finding herself in an increasingly desperate situation, Héra, the daughter of Helm, must summon the will to lead the resistance against a deadly enemy intent on their total destruction.",
      "popularity": 2669.031,
      "poster_path": "/hE9SAMyMSUGAPsHUGdyl6irv11v.jpg",
      "release_date": "2024-12-05",
      "title": "The Lord of the Rings: The War of the Rohirrim",
      "video": false,
      "vote_average": 6.582,
      "vote_count": 245
    },
    {
      "adult": false,
      "backdrop_path": "/uKb22E0nlzr914bA9KyA5CVCOlV.jpg",
      "genre_ids": [
        18,
        10749,
        14
      ],
      "id": 402431,
      "original_language": "en",
      "original_title": "Wicked",
      "overview": "In the land of Oz, ostracized and misunderstood green-skinned Elphaba is forced to share a room with the popular aristocrat Glinda at Shiz University, and the two's unlikely friendship is tested as they begin to fulfill their respective destinies as Glinda the Good and the Wicked Witch of the West.",
      "popularity": 2606.28,
      "poster_path": "/2E1x1qcHqGZcYuYi4PzVZjzg8IV.jpg",
      "release_date": "2024-11-20",
      "title": "Wicked",
      "video": false,
      "vote_average": 7.4,
      "vote_count": 1061
    },
    {
      "adult": false,
      "backdrop_path": "/cjEcqdRdPQJhYre3HUAc5538Gk8.jpg",
      "genre_ids": [
        28,
        14,
        35
      ],
      "id": 845781,
      "original_language": "en",
      "original_title": "Red One",
      "overview": "After Santa Claus (codename: Red One) is kidnapped, the North Pole's Head of Security must team up with the world's most infamous tracker in a globe-trotting, action-packed mission to save Christmas.",
      "popularity": 2605.596,
      "poster_path": "/cdqLnri3NEGcmfnqwk2TSIYtddg.jpg",
      "release_date": "2024-10-31",
      "title": "Red One",
      "video": false,
      "vote_average": 7.031,
      "vote_count": 1877
    },
    {
      "adult": false,
      "backdrop_path": "/tElnmtQ6yz1PjN1kePNl8yMSb59.jpg",
      "genre_ids": [
        16,
        12,
        10751,
        35
      ],
      "id": 1241982,
      "original_language": "en",
      "original_title": "Moana 2",
      "overview": "After receiving an unexpected call from her wayfinding ancestors, Moana journeys alongside Maui and a new crew to the far seas of Oceania and into dangerous, long-lost waters for an adventure unlike anything she's ever faced.",
      "popularity": 2170.808,
      "poster_path": "/m0SbwFNCa9epW1X60deLqTHiP7x.jpg",
      "release_date": "2024-11-21",
      "title": "Moana 2",
      "video": false,
      "vote_average": 6.989,
      "vote_count": 779
    },
    {
      "adult": false,
      "backdrop_path": "/fzjH7kt1017R9EckLDmWmH5pGhD.jpg",
      "genre_ids": [
        28,
        27,
        53
      ],
      "id": 970450,
      "original_language": "en",
      "original_title": "Werewolves",
      "overview": "A year after a supermoon’s light activated a dormant gene, transforming humans into bloodthirsty werewolves and causing nearly a billion deaths, the nightmare resurfaces as the supermoon rises again. Two scientists attempt to stop the mutation but fail, leaving those exposed to the moonlight to once again become feral werewolves. Chaos engulfs the streets as the scientists struggle to reach one of their family homes, now under siege by the savage creatures.",
      "popularity": 1970.484,
      "poster_path": "/cRTctVlwvMdXVsaYbX5qfkittDP.jpg",
      "release_date": "2024-12-04",
      "title": "Werewolves",
      "video": false,
      "vote_average": 6,
      "vote_count": 115
    },
    {
      "adult": false,
      "backdrop_path": "/au3o84ub27qTZiMiEc9UYzN74V3.jpg",
      "genre_ids": [
        28,
        878,
        53
      ],
      "id": 1035048,
      "original_language": "en",
      "original_title": "Elevation",
      "overview": "A single father and two women venture from the safety of their homes to face monstrous creatures to save the life of a young boy.",
      "popularity": 1885.874,
      "poster_path": "/9knPvD6GLtl1w4pamRomyQKHXyj.jpg",
      "release_date": "2024-11-07",
      "title": "Elevation",
      "video": false,
      "vote_average": 6.26,
      "vote_count": 275
    },
    {
      "adult": false,
      "backdrop_path": "/dWkdmxIkH9y23s9v1PjQFhTGIwo.jpg",
      "genre_ids": [
        28,
        18,
        53
      ],
      "id": 1043905,
      "original_language": "en",
      "original_title": "Dirty Angels",
      "overview": "During the United States' 2021 withdrawal from Afghanistan, a group of female soldiers posing as medical relief are sent back in to rescue a group of kidnapped teenagers caught between ISIS and the Taliban.",
      "popularity": 1579.998,
      "poster_path": "/1y3TG8N8zwwMxqh0qzdyDs3IyCq.jpg",
      "release_date": "2024-12-11",
      "title": "Dirty Angels",
      "video": false,
      "vote_average": 6.6,
      "vote_count": 95
    },
    {
      "adult": false,
      "backdrop_path": "/rhc8Mtuo3Kh8CndnlmTNMF8o9pU.jpg",
      "genre_ids": [
        28,
        53
      ],
      "id": 1005331,
      "original_language": "en",
      "original_title": "Carry-On",
      "overview": "An airport security officer races to outsmart a mysterious traveler forcing him to let a dangerous item slip onto a Christmas Eve flight.",
      "popularity": 1463.608,
      "poster_path": "/sjMN7DRi4sGiledsmllEw5HJjPy.jpg",
      "release_date": "2024-12-05",
      "title": "Carry-On",
      "video": false,
      "vote_average": 6.959,
      "vote_count": 1480
    },
    {
      "adult": false,
      "backdrop_path": "/b0itXhS69X33BvLi7uWjUZQs9MB.jpg",
      "genre_ids": [
        27,
        878
      ],
      "id": 933260,
      "original_language": "en",
      "original_title": "The Substance",
      "overview": "A fading celebrity decides to use a black market drug, a cell-replicating substance that temporarily creates a younger, better version of herself.",
      "popularity": 1228.066,
      "poster_path": "/lqoMzCcZYEFK729d6qzt349fB4o.jpg",
      "release_date": "2024-09-07",
      "title": "The Substance",
      "video": false,
      "vote_average": 7.149,
      "vote_count": 3051
    },
    {
      "adult": false,
      "backdrop_path": "/lntyt4OVDbcxA1l7LtwITbrD3FI.jpg",
      "genre_ids": [
        10749,
        18
      ],
      "id": 1010581,
      "original_language": "es",
      "original_title": "Culpa mía",
      "overview": "Noah must leave her city, boyfriend, and friends to move into William Leister's mansion, the flashy and wealthy husband of her mother Rafaela. As a proud and independent 17 year old, Noah resists living in a mansion surrounded by luxury. However, it is there where she meets Nick, her new stepbrother, and the clash of their strong personalities becomes evident from the very beginning.",
      "popularity": 1152.444,
      "poster_path": "/w46Vw536HwNnEzOa7J24YH9DPRS.jpg",
      "release_date": "2023-06-08",
      "title": "My Fault",
      "video": false,
      "vote_average": 7.9,
      "vote_count": 3325
    },
    {
      "adult": false,
      "backdrop_path": "/A28EE0vgHrB0OdoxWWMfgfyEoYn.jpg",
      "genre_ids": [
        80,
        53,
        28
      ],
      "id": 1276945,
      "original_language": "nl",
      "original_title": "Ferry 2",
      "overview": "After losing his drug empire, Ferry Bouman has found a measure of peace away from Brabant's criminal underworld — until his past catches up to him.",
      "popularity": 1039.681,
      "poster_path": "/8pwdnL3pEISIN1EGmwZzU6hpNVk.jpg",
      "release_date": "2024-12-19",
      "title": "Ferry 2",
      "video": false,
      "vote_average": 5.7,
      "vote_count": 76
    },
    {
      "adult": false,
      "backdrop_path": "/uWOJbarUXfVf6B4o0368dh138eR.jpg",
      "genre_ids": [
        27,
        14,
        18
      ],
      "id": 426063,
      "original_language": "en",
      "original_title": "Nosferatu",
      "overview": "A gothic tale of obsession between a haunted young woman and the terrifying vampire infatuated with her, causing untold horror in its wake.",
      "popularity": 1034.597,
      "poster_path": "/5qGIxdEO841C0tdY8vOdLoRVrr0.jpg",
      "release_date": "2024-12-25",
      "title": "Nosferatu",
      "video": false,
      "vote_average": 6.823,
      "vote_count": 588
    },
    {
      "adult": false,
      "backdrop_path": "/6lE2e6j8qbtQR8aHxQNJlwxdmKV.jpg",
      "genre_ids": [
        28,
        80,
        53
      ],
      "id": 974453,
      "original_language": "en",
      "original_title": "Absolution",
      "overview": "An aging ex-boxer gangster working as muscle for a Boston crime boss receives an upsetting diagnosis.  Despite a faltering memory, he attempts to rectify the sins of his past and reconnect with his estranged children. He is determined to leave a positive legacy for his grandson, but the criminal underworld isn’t done with him and won’t loosen their grip willingly.",
      "popularity": 961.87,
      "poster_path": "/2MeQG5Vq8rUnRAa463BZe5GNhVk.jpg",
      "release_date": "2024-10-31",
      "title": "Absolution",
      "video": false,
      "vote_average": 5.876,
      "vote_count": 229
    },
    {
      "adult": false,
      "backdrop_path": "/6amNYUYvoKsZbg8vE00Yzt9Xn7H.jpg",
      "genre_ids": [
        28,
        35,
        878
      ],
      "id": 533535,
      "original_language": "en",
      "original_title": "Deadpool & Wolverine",
      "overview": "A listless Wade Wilson toils away in civilian life with his days as the morally flexible mercenary, Deadpool, behind him. But when his homeworld faces an existential threat, Wade must reluctantly suit-up again with an even more reluctant Wolverine.",
      "popularity": 919.852,
      "poster_path": "/8cdWjvZQUExUUTzyp4t6EDMubfO.jpg",
      "release_date": "2024-07-24",
      "title": "Deadpool & Wolverine",
      "video": false,
      "vote_average": 7.7,
      "vote_count": 6257
    },
    {
      "adult": false,
      "backdrop_path": "/sQbFupSWM9wUdPj96NZNUOFSP5.jpg",
      "genre_ids": [
        28,
        12,
        53
      ],
      "id": 1000075,
      "original_language": "fr",
      "original_title": "Largo Winch: Le prix de l'argent",
      "overview": "Largo Winch, devastated by the kidnapping of his son, realizes that if he finds those responsible for his bankruptcy, maybe he'll see his son again.",
      "popularity": 885.389,
      "poster_path": "/myS41ZUmFvslkT8LeD2irAKxyrf.jpg",
      "release_date": "2024-07-31",
      "title": "The Price of Money: A Largo Winch Adventure",
      "video": false,
      "vote_average": 5.963,
      "vote_count": 81
    }
  ],
  "total_pages": 48045,
  "total_results": 960900
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
certification
string

The content rating (certification) to filter movies by. Must be used with the region parameter.

​
certification_country
string

The country for which the certification applies. Used in conjunction with certification, certification.gte, or certification.lte filters.

​
certification.gte
string

Filters movies with a certification greater than or equal to the specified value. Must be used with region.

​
certification.lte
string

Filters movies with a certification less than or equal to the specified value. Must be used with region.

​
include_adult
boolean

Whether to include adult content in search results. Defaults to false.

​
include_video
boolean

Whether to include movies that are classified as videos.

​
language
string
default:en-US

The language in which to retrieve movie details, specified using an ISO 639-1 code (e.g., en for English, fr for French).

​
page
integer
default:1

The page number for paginated results.

​
primary_release_year
string

Filters movies by their primary release year.

​
primary_release_date.gte
string

Filters movies with a primary release date greater than or equal to the specified date.

​
primary_release_date.lte
string

Filters movies with a primary release date less than or equal to the specified date.

​
region
string

The region code (ISO 3166-1) to filter results by release location.

​
release_date.gte
string

Filters movies with a release date greater than or equal to the specified date.

​
release_date.lte
string

Filters movies with a release date less than or equal to the specified date.

​
sort_by
enum<string>

The sorting criteria for results.

Available options:
original_title.asc,
original_title.desc,
popularity.asc,
popularity.desc,
revenue.asc,
revenue.desc,
primary_release_date.asc,
primary_release_date.desc,
title.asc,
title.desc,
vote_average.asc,
vote_average.desc,
vote_count.asc,
vote_count.desc
​
vote_average.gte
number

Filters movies with a vote average greater than or equal to the specified value.

​
vote_average.lte
number

Filters movies with a vote average less than or equal to the specified value.

​
vote_count.gte
number

Filters movies with a vote count greater than or equal to the specified value.

​
vote_count.lte
number

Filters movies with a vote count less than or equal to the specified value.

​
watch_region
string

The region code to filter results by available streaming options. Used with with_watch_monetization_types or with_watch_providers.

​
with_cast
string

Filters movies by cast members. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_companies
string

Filters movies by production companies. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_crew
string

Filters movies by crew members. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_genres
string

Filters movies by genres. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_keywords
string

Filters movies by keywords. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_origin_country
string

Filters movies by their country of origin (ISO 3166-1 code).

​
with_original_language
string

Filters movies by their original language (ISO 639-1 code).

​
with_people
string

Filters movies by specific people (actors, directors, etc.). Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

​
with_release_type
string

Filters movies by release type. Possible values are [1, 2, 3, 4, 5]. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic). Can be used with region.

​
with_runtime.gte
string

Filters movies with a runtime greater than or equal to the specified value (in minutes).

​
with_runtime.lte
string

Filters movies with a runtime less than or equal to the specified value (in minutes).

​
with_watch_monetization_types
string

Filters movies by monetization type (e.g., "free", "ads", "buy", "rent", "flatrate").

​
with_watch_providers
string

Filters movies by streaming providers. Accepts a comma-separated list.

​
without_companies
string

Excludes movies associated with specific production companies.

​
without_genres
string

Excludes movies with specific genres.

​
without_keywords
string

Excludes movies with specific keywords.

​
without_watch_providers
string

Excludes movies available on specific streaming providers.

​
year
string

Filters movies by release year.

Response

200 - application/json

Movies

The response is of type object.