Details

This endpoint get the top level details of a movie by ID.

GET /movie/{movie_id}

Details

cURL

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

200

{
  "adult": false,
  "backdrop_path": "/wgvc3PmjQGtYYDWaeuV867mnFDs.jpg",
  "belongs_to_collection": null,
  "budget": 90000000,
  "genres": [
    {
      "id": 878,
      "name": "Science Fiction"
    },
    {
      "id": 28,
      "name": "Action"
    },
    {
      "id": 12,
      "name": "Adventure"
    }
  ],
  "homepage": "https://www.sonypictures.com/movies/thefifthelement",
  "id": 18,
  "imdb_id": "tt0119116",
  "origin_country": [
    "FR"
  ],
  "original_language": "fr",
  "original_title": "Le Cinquième Élément",
  "overview": "In 2257, a taxi driver is unintentionally given the task of saving a young girl who is part of the key that will ensure the survival of humanity.",
  "popularity": 64.567,
  "poster_path": "/fPtlCO1yQtnoLHOwKtWz7db6RGU.jpg",
  "production_companies": [
    {
      "id": 9,
      "logo_path": "/nda3dTUYdDrJ6rZqBpYvY865aDv.png",
      "name": "Gaumont",
      "origin_country": "FR"
    }
  ],
  "production_countries": [
    {
      "iso_3166_1": "FR",
      "name": "France"
    }
  ],
  "release_date": "1997-05-02",
  "revenue": 263920180,
  "runtime": 126,
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    },
    {
      "english_name": "Swedish",
      "iso_639_1": "sv",
      "name": "svenska"
    },
    {
      "english_name": "German",
      "iso_639_1": "de",
      "name": "Deutsch"
    }
  ],
  "status": "Released",
  "tagline": "There is no future without it.",
  "title": "The Fifth Element",
  "video": false,
  "vote_average": 7.6,
  "vote_count": 10759
}

Authorizations

Authorization · string · header · required

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

Path Parameters

movie_id · integer · required

The ID of the movie

Query Parameters

append_to_response · string

comma separated list of endpoints within this namespace, 20 items max

language · string

Defaults to en-US

Response

200 - application/json

Successful

adult · boolean

Indicates whether the content is intended for adult audiences

backdrop_path · string

The relative path to the backdrop image for the content

belongs_to_collection · string

The name or ID of the collection this content belongs to, if applicable

budget · integer

The production budget of the content, expressed in monetary units

genres · object[]

A list of genres associated with the content, each represented as an object

Show child attributes

homepage · string

The URL to the official website of the content

id · integer

A unique identifier assigned to the content

imdb_id · string

The identifier for the content on IMDb

original_language · string

The language in which the content was originally produced, following ISO 639-1 codes

original_title · string

The original title of the content

overview · string

A brief summary or description of the content

popularity · number

A numerical representation of the content's popularity, typically based on audience engagement

poster_path · string

The relative path to the poster image for the content

production_company · object[]

A list of production companies involved in creating the content

Show child attributes

production_countries · object[]

A list of countries where the content was produced

Show child attributes

release_date · string

The official release date of the content in YYYY-MM-DD format

revenue · integer

The total revenue generated by the content, expressed in monetary units

runtime · integer

The total runtime of the content, expressed in minutes

spoken_languages · object[]

A list of languages spoken in the content, each represented as an object

Show child attributes

status · string

The current status of the content

tagline · string

A tagline or short phrase associated with the content

title · string

The official or display title of the content

video · boolean

Indicates whether the content includes video elements

vote_average · number

The average rating given to the content by users

vote_count · integer

The total number of votes or ratings received for the content