Skip to main content
GET
Movie

Authorizations

Authorization
string
header
required

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

Query Parameters

certification
string

This is used in conjunction with region.

certification.gte
string

This is used in conjunction with region

certification.lte
string

This is used in conjunction with region

certification_country
string

This is used in conjunction with the certification, certification.gte and certification.lte filters Data type: string

include_adult
boolean

This specifies if adult rated movie should be retrieved.

Example:

"false"

include_video
boolean

This specifies if video should be included.

Example:

"false"

language
string

This represents the language.

Example:

"en"

page
string

This represents the page number.

Example:

"1"

primary_release_year
string

This represents the primary release year. Data type: Integer

primary_release_date.gte
string

It retrieves the greater than or equal value of the specified release date. Data type: date

primary_release_date.lte
string

It retrieves the lesser than or equal value of the specified release date. Data type: date

region
string

This specifies the region.

release_date.gte
string

It retrieves the greater than or equal value of the specified release date. Data value: Date

Example:

"2024-12-26"

release_date.lte
string

It retrieves the lesser than or equal value of the specified release date.

Example:

"7.343"

sort_by
enum<string>

This represents how the retrieved movie will be sorted.

Available options:
popularity.desc,
popularity.asc,
revenue.asc,
revenue.desc
vote_average.gte
string

It retrieves the average vote count. It retrieves the greater than or equal value of the specified value.

vote_average.lte
string

It retrieves the average vote count. It retrieves the greater than or equal value of the specified value.

vote_count.gte
string

It retrieves the vote count. It retrieves the greater than or equal value of the specified value.

vote_count.lte
string

It retrieves the average vote count. It retrieves the greater than or equal value of the specified value.

watch_region
string

This is used in conjunction with with _watch_monetization_types or with_watch_providers

with_cast
string

This specifies the movie cast. It can be a comma (AND) or pipe (OR) separated query

with_companies
string

This specifies the movie company. It can be a comma (AND) or pipe (OR) separated query

with_crew
string

This specifies the movie crew. It can be a comma (AND) or pipe (OR) separated query

with_genres
string

This specifies the movie genre. It can be a comma (AND) or pipe (OR) separated query

with_keywords
string

This specifies the movie genre. It can be a comma (AND) or pipe (OR) separated query

with_origin_country
string

This specifies the origin of the movie. It can be a comma (AND) or pipe (OR) separated query

with_original_language
string

This specifies the original language of the movie. It can be a comma (AND) or pipe (OR) separated query

Example:

"en"

with_release_type
string

This specifies the release type of the movie. It can be a comma (AND) or pipe (OR) separated query

with_runtime.gte
string

This specifies the movie runtime. It retrieves the greater than or equal value of the specified value. Data type: Integer

with_runtime.lte
string

This specifies the movie runtime. It retrieves the lesserthan or equal value of the specified value. Data type: Integer

with_watch_monetization_types
string

This specifies the watch monetization type. Possible values are: [flatrate, free, ads, rent, buy]

with_watch_providers
string

This specifies the watch providers type. use in conjunction with watch_region

without_companies
string

This indicates that movie should be retrieved without companies.

without_genres
string

This indicates that movie should be retrieved without genres.

without_keywords
string

This indicates that movie should be retrieved without keywords.

without_watch_providers
string

This indicates that movie should be retrieved without watch providers.

year
string

This represents the movie year.

Response

200 - application/json

Movie

page
number
Example:

1

results
object[]
Example:
total_pages
number
Example:

47945

total_results
number
Example:

958885