Endpoints
- AUTHENTICATION
- ACCOUNT
- CERTIFICATIONS
- CHANGES
- COLLECTIONS
- COMPANY
- CONFIGURATION
- CREDIT
- DISCOVER
- FIND
- GENRES
- GUEST SESSIONS
- KEYWORDS
- LISTS
- MOVIE LISTS
- MOVIES
- REVIEWS
- NETWORKS
- PEOPLE LIST
- PEOPLE
- SEARCH
- TRENDING
- TV SERIES LIST
- TV SERIES
- TV SEASONS
- TV EPISODES
- TV EPISODE GROUP
- WATCH PROVIDERS
MOVIES
Details
Get the top level details of a movie by ID.
GET
/
3
/
movie
/
{movie_id}
Copy
curl --request GET \
--url https://api.themoviedb.org/3/movie/{movie_id} \
--header 'Authorization: Bearer <token>'
Copy
{
"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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
This is a unique identifier for a movie.
Example:
""
Query Parameters
This add additional data to the response beyond the initial information requested.
Example:
""
Specifies the language in which the response should be returned.
Example:
"en-US"
Response
200 - application/json
details
The response is of type object
.
Copy
curl --request GET \
--url https://api.themoviedb.org/3/movie/{movie_id} \
--header 'Authorization: Bearer <token>'
Copy
{
"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
}
Assistant
Responses are generated using AI and may contain mistakes.