movies

Discover movies by different types of data like average rating, number of votes, genres and certifications. You can get a valid list of certifications from the CertificationsApi.forMovies method.

Discover also supports a nice list of sort options. See MovieQuery for all of the available options.

Please note, when using certification or certification$lte you must also specify certificationCountry. These two parameters work together in order to filter the results. You can only filter results with the countries we have added to our certifications list.

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 withReleaseType 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.

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma's are treated like an AND and query while pipe's are an OR.

Some examples of what can be done with discover can be found here.