GET
/
3
/
search
/
movie
curl --request GET \
  --url https://api.themoviedb.org/3/3/search/movie \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/zuW6fOiusv4X9nnW3paHGfXcSll.jpg",
      "id": 86311,
      "name": "The Avengers Collection",
      "original_language": "en",
      "original_name": "The Avengers Collection",
      "overview": "A superhero film series produced by Marvel Studios based on the Marvel Comics superhero team of the same name, and part of the Marvel Cinematic Universe (MCU).  The series features an ensemble cast from the Marvel Cinematic Universe series films, as they join forces for the peacekeeping organization S.H.I.E.L.D. led by Nick Fury.",
      "poster_path": "/yFSIUVTCvgYrpalUktulvk3Gi5Y.jpg"
    }
  ],
  "total_pages": 1,
  "total_results": 1
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
query
string

Original, translated or alternative name of the movie you want to search.

Example:

"The Avengers"

​
include_adult
string

defaults to false

Example:

"boolean"

​
language
string

defaults to en-US

Example:

"string"

​
primary_release_year
string
Example:

"string"

​
page
string

defaults to 1

Example:

"int32"

​
region
string
Example:

"string"

​
year
string
Example:

"string"

Response

200 - application/json

search movies

​
page
number
Example:

1

​
results
object[]
Example:
[
  {
    "adult": false,
    "backdrop_path": "/zuW6fOiusv4X9nnW3paHGfXcSll.jpg",
    "id": 86311,
    "name": "The Avengers Collection",
    "original_language": "en",
    "original_name": "The Avengers Collection",
    "overview": "A superhero film series produced by Marvel Studios based on the Marvel Comics superhero team of the same name, and part of the Marvel Cinematic Universe (MCU).  The series features an ensemble cast from the Marvel Cinematic Universe series films, as they join forces for the peacekeeping organization S.H.I.E.L.D. led by Nick Fury.",
    "poster_path": "/yFSIUVTCvgYrpalUktulvk3Gi5Y.jpg"
  }
]
​
total_pages
number
Example:

1

​
total_results
number
Example:

1