Discover movies by different types of data like average rating, number of votes, genres and certifications.
discover_movie(api_key, certification_country = NA, certification = NA,
certification.lte = NA, include_adult = FALSE, include_video = TRUE,
language = NA, page = 1, primary_release_year = NA, primary_release_date.gte = NA,
primary_release_date.lte = NA, release_date.gte = NA, release_date.lte = NA,
sort_by = NA, vote_count.gte = NA, vote_count.lte = NA, vote_average.gte = NA,
vote_average.lte = NA, with_cast = NA, with_crew = NA, with_companies = NA,
with_genres = NA, with_keywords = NA, with_people = NA, year = NA)Your TMDb Consumer Key.
Only include movies with certifications for a specific country. When this value is specified, 'certification.lte' is required. A ISO 3166-1 is expected.
Only include movies with this certification. Expected value is a valid certification for the specificed 'certification_country'.
Only include movies with this certification and lower. Expected value is a valid certification for the specificed 'certification_country'.
Toggle the inclusion of adult titles. Expected value is a boolean, true or false. Default is false.
Toggle the inclusion of items marked as a video. Expected value is a boolean, true or false. Default is true.
A ISO 639-1 code.
The number of the page to show. Minimum 1, maximum 1000.
Filter the results so that only the primary release date year has this value. Expected value is a year.
Filter by the primary release date and only include those which are greater than or equal to the specified value. Expected format is YYYY-MM-DD.
Filter by the primary release date and only include those which are greater than or equal to the specified value. Expected format is YYYY-MM-DD.
Filter by all available release dates and only include those which are greater or equal to the specified value. Expected format is YYYY-MM-DD.
Filter by all available release dates and only include those which are less or equal to the specified value. Expected format is YYYY-MM-DD.
Available options are: popularity.asc, popularity.desc, release_date.asc, release_date.desc, revenue.asc, revenue.desc, primary_release_date.asc, primary_release_date.desc, original_title.asc, original_title.desc, vote_average.asc, vote_average.desc, vote_count.asc, vote_count.desc
Filter movies by their vote count and only include movies that have a vote count that is equal to or lower than the specified value.
Filter movies by their vote count and only include movies that have a vote count that is equal to or lower than the specified value. Expected value is an integer.
Filter movies by their vote average and only include those that have an average rating that is equal to or higher than the specified value. Expected value is a float.
Filter movies by their vote average and only include those that have an average rating that is equal to or lower than the specified value. Expected value is a float.
Only include movies that have this person id added as a cast member. Expected value is an integer (the id of a person). Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Only include movies that have this person id added as a crew member. Expected value is an integer (the id of a person). Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Filter movies to include a specific company. Expected value is an integer (the id of a company). Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Only include movies with the specified genres. Expected value is an integer (the id of a genre). Multiple values can be specified. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Only include movies with the specified genres. Expected value is an integer (the id of a genre). Multiple values can be specified. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Only include movies that have these person id's added as a cast or crew member. Expected value is an integer (the id or ids of a person). Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.
Filter the results by all available release dates that have the specified value added as a year. Expected value is an integer (year).
A list with the following fields:
The current page for the results.
A list of movies that match the query's parameters.
The number of pages for the results.
The number of results.
https://developers.themoviedb.org/3/getting-started
# NOT RUN {
## An example of an authenticated request,
## where api_key is fictitious.
## You can obtain your own at https://www.themoviedb.org/documentation/api
api_key <- "key"
discover_movie(api_key = api_key, certification_country = "IT", certification.lte = 16)
# }
Run the code above in your browser using DataLab