Skip to main content
GET
/
movie
/
{movie_id}
/
similar
Similar
curl --request GET \
  --url https://api.themoviedb.org/3/movie/{movie_id}/similar \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/3YAldML4EDyoC6RBpzceALigrAZ.jpg",
      "genre_ids": [
        18,
        14
      ],
      "id": 9300,
      "original_language": "en",
      "original_title": "Orlando",
      "overview": "England, 1600. Queen Elizabeth I promises Orlando, a young nobleman obsessed with poetry, that she will grant him land and fortune if he agrees to satisfy a very particular request.",
      "popularity": 7.768,
      "poster_path": "/xvz0qZkXXMq3dH2Revxii8drxWc.jpg",
      "release_date": "1992-12-11",
      "title": "Orlando",
      "video": false,
      "vote_average": 6.966,
      "vote_count": 262
    },
    {
      "adult": false,
      "backdrop_path": "/4TQgxCYdaizZr9bfjQYVsZPZVGE.jpg",
      "genre_ids": [
        28,
        80,
        18,
        9648,
        53
      ],
      "id": 9311,
      "original_language": "en",
      "original_title": "Smilla's Sense of Snow",
      "overview": "Smilla Jaspersen, half Danish, half Greenlander, attempts to understand the death of a small boy who falls from the roof of her apartment building. Suspecting wrongdoing, Smilla uncovers a trail of clues leading towards a secretive corporation that has made several mysterious expeditions to Greenland. Scenes from the film were shot in Copenhagen and western Greenland. The film was entered into the 47th Berlin International Film Festival, where director Bille August was nominated for the Golden Bear.",
      "popularity": 11.958,
      "poster_path": "/3eeCYGVWb4Ic8SFpARGWOjyl9Md.jpg",
      "release_date": "1997-02-28",
      "title": "Smilla's Sense of Snow",
      "video": false,
      "vote_average": 6.351,
      "vote_count": 202
    },
    {
      "adult": false,
      "backdrop_path": "/mILBIbGUP465jmCgzFCM2F0JnrZ.jpg",
      "genre_ids": [
        18,
        878,
        53
      ],
      "id": 9314,
      "original_language": "en",
      "original_title": "Nineteen Eighty-Four",
      "overview": "George Orwell's novel of a totalitarian future society in which a man whose daily work is rewriting history tries to rebel by falling in love.",
      "popularity": 10.614,
      "poster_path": "/hrdQlicxuyTg3zyVqq78EsA4Z6J.jpg",
      "release_date": "1984-11-09",
      "title": "Nineteen Eighty-Four",
      "video": false,
      "vote_average": 6.842,
      "vote_count": 1217
    },
    {
      "adult": false,
      "backdrop_path": "/ml1cXQaoou7pNXxRl5V85UAts0q.jpg",
      "genre_ids": [
        35,
        878
      ],
      "id": 9317,
      "original_language": "fr",
      "original_title": "La Soupe aux choux",
      "overview": "Two buddy farmers are visited by aliens who like their domestic cabbage soup.",
      "popularity": 8.77,
      "poster_path": "/zEUG0uqQBAQ9fYV8eL2S2twYAhf.jpg",
      "release_date": "1981-12-02",
      "title": "The Cabbage Soup",
      "video": false,
      "vote_average": 6.345,
      "vote_count": 754
    },
    {
      "adult": false,
      "backdrop_path": "/jP8EBGemoBTZbZGl0mGMsdupByR.jpg",
      "genre_ids": [
        28,
        16,
        878
      ],
      "id": 9323,
      "original_language": "ja",
      "original_title": "GHOST IN THE SHELL",
      "overview": "In the year 2029, the barriers of our world have been broken down by the net and by cybernetics, but this brings new vulnerability to humans in the form of brain-hacking. When a highly-wanted hacker known as 'The Puppetmaster' begins involving them in politics, Section 9, a group of cybernetically enhanced cops, are called in to investigate and stop the Puppetmaster.",
      "popularity": 28.834,
      "poster_path": "/9gC88zYUBARRSThcG93MvW14sqx.jpg",
      "release_date": "1995-11-18",
      "title": "Ghost in the Shell",
      "video": false,
      "vote_average": 7.9,
      "vote_count": 2841
    },
    {
      "adult": false,
      "backdrop_path": "/3sbmRuIpYEH5dMvec4z4JxKQHoj.jpg",
      "genre_ids": [
        10751,
        16,
        12
      ],
      "id": 9325,
      "original_language": "en",
      "original_title": "The Jungle Book",
      "overview": "The boy Mowgli makes his way to the man-village with Bagheera, the wise panther. Along the way he meets jazzy King Louie, the hypnotic snake Kaa and the lovable, happy-go-lucky bear Baloo, who teaches Mowgli \"The Bare Necessities\" of life and the true meaning of friendship.",
      "popularity": 55.252,
      "poster_path": "/yN1kuupnPTLUprgfvC5WapgrxG4.jpg",
      "release_date": "1967-10-18",
      "title": "The Jungle Book",
      "video": false,
      "vote_average": 7.28,
      "vote_count": 5650
    },
    {
      "adult": false,
      "backdrop_path": "/uhBTaysiWU3dIQFHiVWXHuqO4OZ.jpg",
      "genre_ids": [
        28,
        18,
        53
      ],
      "id": 9331,
      "original_language": "en",
      "original_title": "Clear and Present Danger",
      "overview": "CIA Analyst Jack Ryan is drawn into an illegal war fought by the US government against a Colombian drug cartel.",
      "popularity": 20.458,
      "poster_path": "/6xTM8FPxrLRYwz6I3fqtwh7xybs.jpg",
      "release_date": "1994-08-03",
      "title": "Clear and Present Danger",
      "video": false,
      "vote_average": 6.609,
      "vote_count": 1261
    },
    {
      "adult": false,
      "backdrop_path": "/cO8zcdPhLT3UdykkXCvfhIVrgHK.jpg",
      "genre_ids": [
        28,
        12,
        878
      ],
      "id": 9355,
      "original_language": "en",
      "original_title": "Mad Max Beyond Thunderdome",
      "overview": "Mad Max becomes a pawn in a decadent oasis of a technological society, and when exiled, becomes the deliverer of a colony of children.",
      "popularity": 30.407,
      "poster_path": "/jJlxcEVVUHnrUeEkQ0077VeHQpb.jpg",
      "release_date": "1985-06-29",
      "title": "Mad Max Beyond Thunderdome",
      "video": false,
      "vote_average": 6.196,
      "vote_count": 2430,
      "total_pages": 364,
      "total_results": 7269
    }
  ]
}
This method only looks for other items based on genres and plot keywords. As such, the results found here are not always going to be 💯. Use it with that in mind.

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

​
language
string

Defaults to false

​
page
integer

Defaults to 1

Response

200 - application/json

Successful

​
page
integer

Indicates the current page number

​
results
object[]

Contains the list of data or items

​
total_pages
integer

Specifies the total number of pages available

​
total_results
integer

Represents the total number of items or records in a dataset