Movie

This endpoint find movies using over 30 filters and sort options.

GET /discover/movie

Movie

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/discover/movie \
  --header 'Authorization: Bearer <token>'

200

{
  "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": 7979.938,
      "poster_path": "/2cxhvwyEwRlysAmRH4iodkvo0z5.jpg",
      "release_date": "2024-11-05",
      "title": "Gladiator II",
      "video": false,
      "vote_average": 6.781,
      "vote_count": 1622
    },
    {
      "adult": false,
      "backdrop_path": "/6qld2YxAO9gdEblo0rsEb8BcYKO.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": 5541.871,
      "poster_path": "/1sQA7lfcF9yUyoLYC0e6Zo3jmxE.jpg",
      "release_date": "2024-12-26",
      "title": "Your Fault",
      "video": false,
      "vote_average": 7.737,
      "vote_count": 300
    },
    {
      "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": 4938.342,
      "poster_path": "/cdqLnri3NEGcmfnqwk2TSIYtddg.jpg",
      "release_date": "2024-10-31",
      "title": "Red One",
      "video": false,
      "vote_average": 7.051,
      "vote_count": 1573,
      "total_pages": 17910,
      "total_results": 158200
    }
  ]
}

Advanced Filtering

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It’s important to note the order of the release types that are used. Specifying 2|3 would return the limited theatrical release date as opposed to 3|2 which would return the theatrical date.

Authorizations

Authorization · string · header · required

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

Query Parameters

certificate · string

Use in conjunction with region

certification.gte · string

Use in conjunction with region

certification.lte · string

Use in conjunction with region

certification_country · string

Use in conjunction with the certification, certification.gte, and certification.lte filters

include_adult · boolean

Defaults to false

include_video · boolean

Defaults to false

language · string

Defaults to en-US

page · string

Defaults to 1

primary_release_year · integer

Use in conjunction with region

primary_release_date.gte · string<date>

Use in conjunction with region

primary_release_date.lte · string<date>

Use in conjunction with region

region · string

Use in conjunction with region

release_date.gte · string<date>

Use in conjunction with region

release_date.lte · string<date>

Use in conjunction with region

sort_by · string

Defaults to popularity.desc

vote_average.gte · number<float>

Minimum average vote score to include

vote_average.lte · number<float>

Minimum average vote score to include

vote_count.gte · number<float>

Minimum average vote score to include

vote_count.lte · number<float>

Minimum average vote score to include

watch_region · string

Use in conjunction with with_watch_monetization_types or with_watch_providers

with_cast · string

Can be a comma, pipe or separated query

with_companies · string

Can be a comma, pipe or separated query

with_crew · string

Can be a comma, pipe or separated query

with_genres · string

Can be a comma, pipe or separated query

with_keywords · string

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

with_origin_country · string

Use in conjunction with region

with_original_language · string

Use in conjunction with region

with_people · string

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

with_release_type · integer

Can be a comma (AND) or pipe (OR) separated query, can be used in conjunction with region

with_runtime.gte · integer

Use in conjunction with region

with_runtime.lte · integer

Use in conjunction with region

with_watch_monetization_types · string

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

with_watch_providers · string

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

without_companies · string

Use in conjunction with region

without_genres · string

Use in conjunction with region

without_keywords · string

Use in conjunction with region

without_watch_providers · string

Use in conjunction with region

year · integer

Use in conjunction with region

Response

200 - application/json

Successful

page · integer

Indicates the current page number

results · object[]

Contains the list of data or items

Show child attributes

total_pages · integer

Specifies the total number of pages available

total_results · integer

Represents the total number of items or records in a dataset