Skip to main content
GET
Discover movies with filters

Authorizations

Authorization
string
header
required

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

Query Parameters

certification
string

used together with region

Example:

"string "

certification.gte
string

used together with region

Example:

"string"

certification.lte
string

used together with region

Example:

"string"

certification_country
string

use together with the certification, certification.gte and certification.lte filters

Example:

"string"

include_adult
string

Defaults to false

Example:

"boolean"

include_video
string

Defaults to false

Example:

"boolean"

language
string

Defaults to en-US

Example:

"string"

page
string

Defaults to 1

Example:

"int32"

primary_release_year
string

The year the movie was released

Example:

"int32"

primary_release_date.gte
string
Example:

"date"

primary_release_date.lte
string
Example:

"date"

region
string
Example:

"string"

release_date.gte
string
Example:

"date"

release_date.lte
string
Example:

"date"

sort_by
string

Defaults to popularity.desc

Example:

"string"

vote_average.gte
string
Example:

"float"

vote_average.lte
string
Example:

"float"

vote_count.gte
string
Example:

"float"

vote_count.lte
string
Example:

"float"

watch_region
string

use together with with_watch_monetization_types or with_watch_providers

Example:

"string"

with_cast
string

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

Example:

"string"

with_companies
string

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

Example:

"string"

with_crew
string

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

Example:

"string"

with_genres
string

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

Example:

"string"

with_keywords
string

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

Example:

"string"

with_origin_country
string
Example:

"string"

with_original_language
string
Example:

"string"

with_people
string

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

Example:

"string"

with_release_type
string

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

Example:

"int32"

with_runtime.gte
string
Example:

"string"

with_watch_monetization_types
string

possible values are: [flatrate, free, ads, rent, buy] use in conjunction with watch_region, can be a comma (AND) or pipe (OR) separated query

Example:

"string"

with_watch_providers
string

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

Example:

"string"

without_companies
string
Example:

"string"

without_genres
string
Example:

"string"

without_keywords
string
Example:

"string"

without_watch_providers
string
Example:

"string"

year
string
Example:

"int32"

Response

200 - application/json

discover-movies

page
number
Example:

1

results
object[]
Example:
total_pages
number
Example:

47624

total_results
number
Example:

952464