Movie Info

Detailed information on a specific movie specified by Id. You can use the movies search endpoint or peruse the lists of movies/dvds to get the urls to movies.

URL

http://api.rottentomatoes.com/api/public/v1.0/movies/770672122.json?apikey=[your_api_key]

Parameters

no parameters

Example Call and Response

http://api.rottentomatoes.com/api/public/v1.0/movies/770672122.json?apikey=[your_api_key]

{
  "id": 770672122,
  "title": "Toy Story 3",
  "year": 2010,
  "genres": [
    "Animation",
    "Kids & Family",
    "Science Fiction & Fantasy",
    "Comedy"
  ],
  "mpaa_rating": "G",
  "runtime": 103,
  "critics_consensus": "Deftly blending comedy, adventure, and honest emotion, Toy Story 3 is a rare second sequel that really works.",
  "release_dates": {
    "theater": "2010-06-18",
    "dvd": "2010-11-02"
  },
  "ratings": {
    "critics_rating": "Certified Fresh",
    "critics_score": 99,
    "audience_rating": "Upright",
    "audience_score": 91
  },
  "synopsis": "Pixar returns to their first success with Toy Story 3. The movie begins with Andy leaving for college and donating his beloved toys -- including Woody (Tom Hanks) and Buzz (Tim Allen) -- to a daycare. While the crew meets new friends, including Ken (Michael Keaton), they soon grow to hate their new surroundings and plan an escape. The film was directed by Lee Unkrich from a script co-authored by Little Miss Sunshine scribe Michael Arndt. ~ Perry Seibert, Rovi",
  "posters": {
    "thumbnail": "http://content6.flixster.com/movie/11/13/43/11134356_mob.jpg",
    "profile": "http://content6.flixster.com/movie/11/13/43/11134356_pro.jpg",
    "detailed": "http://content6.flixster.com/movie/11/13/43/11134356_det.jpg",
    "original": "http://content6.flixster.com/movie/11/13/43/11134356_ori.jpg"
  },
  "abridged_cast": [
    {
      "name": "Tom Hanks",
      "characters": ["Woody"]
    },
    {
      "name": "Tim Allen",
      "characters": ["Buzz Lightyear"]
    },
    {
      "name": "Joan Cusack",
      "characters": ["Jessie the Cowgirl"]
    },
    {
      "name": "Don Rickles",
      "characters": ["Mr. Potato Head"]
    },
    {
      "name": "Wallace Shawn",
      "characters": ["Rex"]
    }
  ],
  "abridged_directors": [{"name": "Lee Unkrich"}],
  "studio": "Walt Disney Pictures",
  "alternate_ids": {"imdb": "0435761"},
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122.json",
    "alternate": "http://www.rottentomatoes.com/m/toy_story_3/",
    "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/cast.json",
    "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/clips.json",
    "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/reviews.json",
    "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/similar.json"
  }
}

7 Comments

  1. kunal2 years ago

    when I do this same call, I get a blank synopsis, is that supposed to happen?

  2. Steve N.2 years ago

    Hi kunal, Please see this thread: http://developer.rottentomatoes.com/forum/read/113197
    I've updated the example response with a more recent movie that contains the synopsis

  3. anonymustard2 years ago

    Is there a way to retrieve the number of rotten/fresh reviews and number of user ratings?

  4. Steve N.2 years ago

    Hi anonymustard,
    There isn't a way currently - I've added your request to the Feature Request Forum: http://developer.rottentomatoes.com/forum/read/113677

  5. miweb1231 year ago

    Sorry I must be very new at this, where do I find a movie ID. I try using the end of the URL m/alamar ? how do I " search endpoint or peruse the lists of movies/dvds" for dummies? TKS

  6. JitenMS1 year ago

    Hi- Can someone provide confirmation if Movie Info API supports passing AMG Movie ID? the example doesn't seems to say that. I want to explore the scenario where we have AMG movie id and now we want to get RT's movie Reviews

  7. abhisom2 months ago

    "synopsis" is empty for most of movies( troy ,blade runner ,spiderman etc ),i can't fetch data about these movies,even if the data is given in site .please fix this issue.

Please sign in to post a comment.