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"
  }
}

6 Comments

  1. kunal1 year ago

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

  2. Steve N.1 year 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. anonymustard1 year ago

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

  4. Steve N.1 year 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. miweb1233 months 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. JitenMS2 months 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

Please sign in to post a comment.