Search movies

curl --request GET \
  --url https://api.themoviedb.org/3/3/search/movie \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/3/search/movie', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/3/search/movie",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/3/search/movie"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/3/search/movie")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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
}

GET

movie

Search movies

curl --request GET \
  --url https://api.themoviedb.org/3/3/search/movie \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/3/search/movie', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/3/search/movie",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/3/search/movie"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/3/search/movie")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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[]

Show child attributes

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