GET
/
3
/
movie
/
{movie_id}
Details
curl --request GET \
  --url https://api.themoviedb.org/3/movie/{movie_id} \
  --header 'Authorization: Bearer <token>'
{
  "adult": false,
  "backdrop_path": "/euYIwmwkmz95mnXvufEmbL6ovhZ.jpg",
  "belongs_to_collection": {
    "backdrop_path": "/1VdLvSIeHuwqCT13H9EafxCacGB.jpg",
    "id": 1069584,
    "name": "Gladiator Collection",
    "poster_path": "/r7uyUOB6fmmPumWwHiV7Hn2kUbL.jpg"
  },
  "budget": 310000000,
  "genres": [
    {
      "id": 28,
      "name": "Action"
    },
    {
      "id": 12,
      "name": "Adventure"
    },
    {
      "id": 18,
      "name": "Drama"
    }
  ],
  "homepage": "https://www.gladiator.movie",
  "id": 558449,
  "imdb_id": "tt9218128",
  "origin_country": [
    "US"
  ],
  "original_language": "en",
  "original_title": "Gladiator II",
  "overview": "Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people.",
  "popularity": 5382.147,
  "poster_path": "/2cxhvwyEwRlysAmRH4iodkvo0z5.jpg",
  "production_companies": [
    {
      "id": 4,
      "logo_path": "/gz66EfNoYPqHTYI4q9UEN4CbHRc.png",
      "name": "Paramount Pictures",
      "origin_country": "US"
    },
    {
      "id": 221347,
      "logo_path": "/6Ry6uNBaa0IbbSs1XYIgX5DkA9r.png",
      "name": "Scott Free Productions",
      "origin_country": "US"
    },
    {
      "id": 246486,
      "logo_path": null,
      "name": "Lucy Fisher/Douglas Wick Productions",
      "origin_country": "US"
    }
  ],
  "production_countries": [
    {
      "iso_3166_1": "US",
      "name": "United States of America"
    }
  ],
  "release_date": "2024-11-05",
  "revenue": 435417355,
  "runtime": 148,
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    }
  ],
  "status": "Released",
  "tagline": "Prepare to be entertained.",
  "title": "Gladiator II",
  "video": false,
  "vote_average": 6.8,
  "vote_count": 1875
}

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

This is a unique identifier for a movie.

Example:

""

Query Parameters

append_to_response
string

This add additional data to the response beyond the initial information requested.

Example:

""

language
string

Specifies the language in which the response should be returned.

Example:

"en-US"

Response

200 - application/json

details

adult
boolean

A boolean indicating whether the movie is intended for an adult audience (true if it contains adult content, false otherwise).

Example:

false

backdrop_path
string

A string representing the path to the movie's backdrop image.

Example:

"/euYIwmwkmz95mnXvufEmbL6ovhZ.jpg"

belongs_to_collection
object

An object containing information about collections that this movie belongs to.

budget
number

The estimated production budget of the movie, measured in US dollars.

Example:

310000000

genres
object[]

An array of objects representing the genres of the movie

Example:
[
{ "id": 28, "name": "Action" },
{ "id": 12, "name": "Adventure" },
{ "id": 18, "name": "Drama" }
]
homepage
string

A URL to the official website of the movie, which may provide more information, trailers, or promotional content.

Example:

"https://www.gladiator.movie"

id
number

Unique identifier for the movie within the database.

Example:

558449

imdb_id
string

The unique identifier used on IMDb for the movie

Example:

"tt9218128"

origin_country
string[]

An array indicating the countries where the movie was produced.

Example:
["US"]
original_language
string

The primary language in which the movie was made.

Example:

"en"

original_title
string

The original title of the movie as it was first released.

Example:

"Gladiator II"

overview
string

A brief summary of the movie's plot.

Example:

"Years after witnessing the death of the revered hero Maximus at the hands of his uncle, Lucius is forced to enter the Colosseum after his home is conquered by the tyrannical Emperors who now lead Rome with an iron fist. With rage in his heart and the future of the Empire at stake, Lucius must look to his past to find strength and honor to return the glory of Rome to its people."

popularity
number

A numerical value indicating the popularity of the movie.

Example:

5382.147

poster_path
string

A string that represents the path to the official poster image for the movie.

Example:

"/2cxhvwyEwRlysAmRH4iodkvo0z5.jpg"

production_companies
object[]

An array of objects showing the companies that produced the movie.

Example:
[
{
"id": 4,
"logo_path": "/gz66EfNoYPqHTYI4q9UEN4CbHRc.png",
"name": "Paramount Pictures",
"origin_country": "US"
},
{
"id": 221347,
"logo_path": "/6Ry6uNBaa0IbbSs1XYIgX5DkA9r.png",
"name": "Scott Free Productions",
"origin_country": "US"
},
{
"id": 246486,
"logo_path": null,
"name": "Lucy Fisher/Douglas Wick Productions",
"origin_country": "US"
}
]
production_countries
object[]

An array of objects that denote the countries involved in the film’s production.

Example:
[
{
"iso_3166_1": "US",
"name": "United States of America"
}
]
release_date
string

The official release date of the movie.

Example:

"2024-11-05"

revenue
number

The total gross revenue generated by the movie, measured in US dollars (here, $435,417,355).

Example:

435417355

runtime
number

The total run time of the movie, expressed in minutes.

Example:

148

spoken_languages
object[]

An array of objects representing the languages spoken in the movie.

Example:
[
{
"english_name": "English",
"iso_639_1": "en",
"name": "English"
}
]
status
string

The current release status of the movie.

Example:

"Released"

tagline
string

A brief, catchy phrase or slogan that helps promote the movie.

Example:

"Prepare to be entertained."

title
string

The title of the movie as it is officially known.

Example:

"Gladiator II"

video
boolean

A boolean value indicating whether there is an associated video (such as a trailer) available for the movie. true means there is a video, whereas false indicates there is none.

Example:

false

vote_average
number

The average rating that the movie has received from viewers, usually on a scale from 1 to 10.

Example:

6.8

vote_count
number

The total number of votes or ratings submitted for the movie.

Example:

1875