Skip to main content
GET
Movies

Authorizations

Authorization
string
header
required

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

Query Parameters

certification
string

The content rating (certification) to filter movies by. Must be used with the region parameter.

certification_country
string

The country for which the certification applies. Used in conjunction with certification, certification.gte, or certification.lte filters.

certification.gte
string

Filters movies with a certification greater than or equal to the specified value. Must be used with region.

certification.lte
string

Filters movies with a certification less than or equal to the specified value. Must be used with region.

include_adult
boolean

Whether to include adult content in search results. Defaults to false.

include_video
boolean

Whether to include movies that are classified as videos.

language
string
default:en-US

The language in which to retrieve movie details, specified using an ISO 639-1 code (e.g., en for English, fr for French).

page
integer
default:1

The page number for paginated results.

primary_release_year
string<date>

Filters movies by their primary release year.

primary_release_date.gte
string<date>

Filters movies with a primary release date greater than or equal to the specified date.

primary_release_date.lte
string<date>

Filters movies with a primary release date less than or equal to the specified date.

region
string

The region code (ISO 3166-1) to filter results by release location.

release_date.gte
string<date>

Filters movies with a release date greater than or equal to the specified date.

release_date.lte
string<date>

Filters movies with a release date less than or equal to the specified date.

sort_by
enum<string>

The sorting criteria for results.

Available options:
original_title.asc,
original_title.desc,
popularity.asc,
popularity.desc,
revenue.asc,
revenue.desc,
primary_release_date.asc,
primary_release_date.desc,
title.asc,
title.desc,
vote_average.asc,
vote_average.desc,
vote_count.asc,
vote_count.desc
vote_average.gte
number<float>

Filters movies with a vote average greater than or equal to the specified value.

vote_average.lte
number<float>

Filters movies with a vote average less than or equal to the specified value.

vote_count.gte
number<float>

Filters movies with a vote count greater than or equal to the specified value.

vote_count.lte
number<float>

Filters movies with a vote count less than or equal to the specified value.

watch_region
string

The region code to filter results by available streaming options. Used with with_watch_monetization_types or with_watch_providers.

with_cast
string

Filters movies by cast members. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_companies
string

Filters movies by production companies. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_crew
string

Filters movies by crew members. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_genres
string

Filters movies by genres. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_keywords
string

Filters movies by keywords. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_origin_country
string

Filters movies by their country of origin (ISO 3166-1 code).

with_original_language
string

Filters movies by their original language (ISO 639-1 code).

with_people
string

Filters movies by specific people (actors, directors, etc.). Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic).

with_release_type
string

Filters movies by release type. Possible values are [1, 2, 3, 4, 5]. Accepts a comma-separated list (AND logic) or a pipe-separated list (OR logic). Can be used with region.

with_runtime.gte
string

Filters movies with a runtime greater than or equal to the specified value (in minutes).

with_runtime.lte
string

Filters movies with a runtime less than or equal to the specified value (in minutes).

with_watch_monetization_types
string

Filters movies by monetization type (e.g., "free", "ads", "buy", "rent", "flatrate").

with_watch_providers
string

Filters movies by streaming providers. Accepts a comma-separated list.

without_companies
string

Excludes movies associated with specific production companies.

without_genres
string

Excludes movies with specific genres.

without_keywords
string

Excludes movies with specific keywords.

without_watch_providers
string

Excludes movies available on specific streaming providers.

year
string

Filters movies by release year.

Response

200 - application/json

Movies

page
number
Example:

1

results
object[]
Example:
total_pages
number
Example:

48045

total_results
number
Example:

960900