v1

latestOpenAPI 3.1.02026-07-24270489.8 KB

Movie

Find movies using over 30 filters and sort options.

get/3/discover/movie

Query parameters

certificationstring

use in conjunction with region

certification.gtestring

use in conjunction with region

certification.ltestring

use in conjunction with region

certification_countrystring

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

include_adultboolean

include_videoboolean

languagestring

pageinteger

primary_release_yearinteger

primary_release_date.gtestring date

primary_release_date.ltestring date

regionstring

release_date.gtestring date

release_date.ltestring date

sort_by'original_title.asc' | 'original_title.desc' | 'popularity.asc' | 'popularity.desc' | 'revenue.asc' | 'revenue.desc' | 'primary_release_date.asc' | 'title.asc' | 'title.desc' | 'primary_release_date.desc' | 'vote_average.asc' | 'vote_average.desc' | 'vote_count.asc' | 'vote_count.desc'

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_caststring

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

with_companiesstring

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

with_crewstring

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_origin_countrystring

with_original_languagestring

with_peoplestring

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

with_release_typeinteger

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

with_runtime.gteinteger

with_runtime.lteinteger

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

yearinteger

Response

200

pageinteger

total_pagesinteger

total_resultsinteger

Example response

{
  "page": 1,
  "results": [
    {
      "backdrop_path": "/8YFL5QQVPy3AgrEQxNYVSgiPEbe.jpg",
      "genre_ids": [
        28
      ],
      "id": 640146,
      "original_language": "en",
      "original_title": "Ant-Man and the Wasp: Quantumania",
      "overview": "Super-Hero partners Scott Lang and Hope van Dyne, along with with Hope's parents Janet van Dyne and Hank Pym, and Scott's daughter Cassie Lang, find themselves exploring the Quantum Realm, interacting with strange new creatures and embarking on an adventure that will push them beyond the limits of what they thought possible.",
      "popularity": 9272.643,
      "poster_path": "/ngl2FKBlU4fhbdsrtdom9LVLBXw.jpg",
      "release_date": "2023-02-15",
      "title": "Ant-Man and the Wasp: Quantumania",
      "vote_average": 6.5,
      "vote_count": 1856
    }
  ],
  "total_pages": 38020,
  "total_results": 760385
}