Movie Reviews

Retrieves the reviews for a movie. Results are paginated if they go past the specified page limit

URL

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

Parameters

ParameterRequiredDefaultDescription
review_type false top_critic 3 different review types are possible: "all", "top_critic" and "dvd". "top_critic" shows all the Rotten Tomatoes designated top critics. "dvd" pulls the reviews given on the DVD of the movie. "all" as the name implies retrieves all reviews.
page_limit false 20 The number of reviews to show per page
page false 1 The selected page of reviews
country false us Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.

Example Call and Response

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

{
  "total": 39,
  "reviews": [
    {
      "critic": "Joe Baltake",
      "date": "2010-07-27",
      "freshness": "fresh",
      "publication": "Passionate Moviegoer",
      "quote": "'Toy Story 3': Alternately affecting, hilarious and heartbreaking and the most original prison-escape movie ever made",
      "links": {"review": "http://thepassionatemoviegoer.blogspot.com/2010/07/perfectimperfect.html"}
    },
    {
      "critic": "Rafer Guzman",
      "date": "2010-07-06",
      "freshness": "fresh",
      "publication": "Newsday",
      "quote": "It's sadder and scarier than its predecessors, but it also may be the most important chapter in the tale.",
      "links": {"review": "http://www.newsday.com/entertainment/movies/toy-story-3-andy-grows-up-1.2028598"}
    },
    {
      "critic": "Richard Roeper",
      "date": "2010-06-30",
      "original_score": "5/5",
      "freshness": "fresh",
      "publication": "Richard Roeper.com",
      "quote": "The best movie of the year so far.",
      "links": {"review": "http://www.richardroeper.com/reviews/toystory3.aspx"}
    },
    {
      "critic": "David Edelstein",
      "date": "2010-06-18",
      "freshness": "fresh",
      "publication": "New York Magazine",
      "quote": "The gags are all of a piece, right up to the forlorn yet enchanting finale.",
      "links": {"review": "http://nymag.com/movies/reviews/66799/"}
    },
    {
      "critic": "Liam Lacey",
      "date": "2010-06-18",
      "original_score": "3/4",
      "freshness": "fresh",
      "publication": "Globe and Mail",
      "quote": "At its best, most moving moments, Toy Story 3 is a story about the pang of a young adult moving away from home and leaving child-like things behind.",
      "links": {"review": "http://www.theglobeandmail.com/news/arts/movies/toy-story-3-three-times-less-of-a-charm/article1607696/"}
    },
    {
      "critic": "Peter Travers",
      "date": "2010-06-18",
      "original_score": "3.5/4",
      "freshness": "fresh",
      "publication": "Rolling Stone",
      "quote": "It hits every button from laughter to tears and lifts you up on waves of visual dazzlement. And you don't need to take a kid along to appreciate it... Tag it as one of the year's best.",
      "links": {"review": "http://www.rollingstone.com/movies/reviews/toy-story-3-20100617"}
    },
    {
      "critic": "James Rocchi",
      "date": "2010-06-18",
      "original_score": "4.5/5",
      "freshness": "fresh",
      "publication": "MSN Movies",
      "quote": "Toy Story 3 succeeds not because of its glossy and gleaming high-tech pixels, but rather because it is so well-written that you could tell it with low-tech hand puppets and still thrill and reach an audience of children and adults both.",
      "links": {
        "review": "http://movies.msn.com/movies/movie-critic-reviews/toy-story-3.2/",
        "publication": "http://movies.msn.com"
      }
    },
    {
      "critic": "Lisa Kennedy",
      "date": "2010-06-18",
      "original_score": "3/4",
      "freshness": "fresh",
      "publication": "Denver Post",
      "quote": "Consider the oft-amusing, terribly clever G-rated sequel Toy Story 3 as the brightest student in the class delivering a very fine B paper.",
      "links": {"review": "http://www.denverpost.com/entertainmentheadlines/ci_15312141"}
    },
    {
      "critic": "Christopher Orr",
      "date": "2010-06-18",
      "freshness": "fresh",
      "publication": "The Atlantic",
      "quote": "As Lotso, Ned Beatty offers the most compelling portrait of avuncular villainy since, well, Ned Beatty in Network, and Michael Keaton's Ken is the quintessence of himbo-ism.",
      "links": {"review": "http://www.theatlantic.com/culture/archive/2010/06/the-simple-pleasure-of-toy-story-3/58325/"}
    },
    {
      "critic": "Lou Lumenick",
      "date": "2010-06-18",
      "original_score": "3.5/4",
      "freshness": "fresh",
      "publication": "New York Post",
      "quote": "Toy Story 3 may not be a masterpiece, but it still had me in tears at the end.",
      "links": {"review": "http://www.nypost.com/p/entertainment/movies/great_escape_PXdfN7x7cHEaIvArzZpMsI"}
    },
    {
      "critic": "Andrew O'Hehir",
      "date": "2010-06-18",
      "freshness": "fresh",
      "publication": "Salon.com",
      "quote": "A bona fide summer delight loaded with action, humor, nostalgia, a veritable blizzard of pop-culture references and general good vibes.",
      "links": {"review": "http://www.salon.com/entertainment/movies/toy_story_3/index.html?story=/ent/movies/andrew_ohehir/2010/06/17/toy_story_3"}
    },
    {
      "critic": "Stephen Whitty",
      "date": "2010-06-18",
      "original_score": "4/4",
      "freshness": "fresh",
      "publication": "Newark Star-Ledger",
      "quote": "It's a sequel. It's in 3-D. It has no kiddie-flick competition. Really, how good does it have to be? Apparently, as good as Pixar can make it.",
      "links": {"review": "http://www.nj.com/entertainment/movies/index.ssf/2010/06/toy_story_3_movie_review_a_story_that_just_keeps_getting_better.html"}
    },
    {
      "critic": "Laremy Legel",
      "date": "2010-06-17",
      "original_score": "B+",
      "freshness": "fresh",
      "publication": "Film.com",
      "quote": "A worthy finale to a fantastic franchise.",
      "links": {"review": "http://www.film.com/features/story/review-toy-story-3-shines/38886308"}
    },
    {
      "critic": "Mick LaSalle",
      "date": "2010-06-17",
      "original_score": "4/4",
      "freshness": "fresh",
      "publication": "San Francisco Chronicle",
      "quote": "The story mixes comedy, drama and action with impressive skill, except this is beyond skill -- this is inspired.",
      "links": {"review": "http://www.sfgate.com/cgi-bin/article.cgi?f=/c/a/2010/06/18/MVRI1E05IA.DTL"}
    },
    {
      "critic": "Joe Morgenstern",
      "date": "2010-06-17",
      "freshness": "fresh",
      "publication": "Wall Street Journal",
      "quote": "I won't tell you what that ending is, but it took my breath away, and I'll bet it takes yours. Do see this lovely film sooner than later.",
      "links": {"review": "http://online.wsj.com/article/SB10001424052748704289504575312602886439646.html?mod=WSJ_ArtsEnt_LifestyleArtEnt_2"}
    },
    {
      "critic": "Kenneth Turan",
      "date": "2010-06-17",
      "original_score": "4/5",
      "freshness": "fresh",
      "publication": "Los Angeles Times",
      "quote": "Toy Story 3 pays attention to the reasons we return again and again to the motion picture experience.",
      "links": {"review": "http://www.latimes.com/entertainment/news/la-et-toystory-20100618,0,2489391.story"}
    },
    {
      "critic": "Richard Corliss",
      "date": "2010-06-17",
      "freshness": "fresh",
      "publication": "TIME Magazine",
      "quote": "Some toys -- and Toy Storys -- are to be treasured forever.",
      "links": {"review": "http://www.time.com/time/magazine/article/0,9171,1993864,00.html"}
    },
    {
      "critic": "Colin Covert",
      "date": "2010-06-17",
      "original_score": "4/4",
      "freshness": "fresh",
      "publication": "Minneapolis Star Tribune",
      "quote": "I'd like to thank the folks at Pixar for ending Toy Story 3 with a nice long gag reel alongside the final credits. It gave me time to blot away my tears before entering the lobby.",
      "links": {"review": "http://www.startribune.com/entertainment/movies/96575364.html?elr=KArksD:aDyaEP:kD:aUnc5PDiUiD3aPc:_Yyc:aULPQL7PQLanchO7DiUr"}
    },
    {
      "critic": "Charlie McCollum",
      "date": "2010-06-17",
      "original_score": "3.5/4",
      "freshness": "fresh",
      "publication": "San Jose Mercury News",
      "quote": "In a summer that will be littered with bad sequels, bad 3-D and bad storytelling, it is a movie to be heartily embraced.",
      "links": {"review": "http://www.mercurynews.com/movies-dvd/ci_15304117?nclick_check=1"}
    },
    {
      "critic": "Chris Vognar",
      "date": "2010-06-17",
      "original_score": "5/5",
      "freshness": "fresh",
      "publication": "Dallas Morning News",
      "quote": "The technical wizardry only enhances Toy Story 3's emotional resonance.",
      "links": {"review": "http://www.dallasnews.com/sharedcontent/dws/ent/movies/reviews/stories/061710dngdtoystory3.4eb1683.html"}
    }
  ],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/reviews.json?review_type=top_critic&page_limit=20&country=us&page=1",
    "next": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122/reviews.json?review_type=top_critic&page_limit=20&country=us&page=2",
    "alternate": "http://www.rottentomatoes.com/m/toy_story_3/#reviews",
    "rel": "http://api.rottentomatoes.com/api/public/v1.0/movies/770672122.json"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/movies/{movie-id}/reviews.json?review_type={top_critic|all|dvd}&page_limit={results-per-page}&page={page-number}&country={country-code}"
}
 


12 Comments

  1. anonymustard3 years ago

    Is there a way to determine if a specific review is Rotten or Fresh? (without parsing original_score which differs across reviewers and is sometimes absent altogether)

  2. Steve N.3 years ago

    Hi anonymustard, Not currently. I've added your request to the Feature Request Forum. http://developer.rottentomatoes.com/forum/read/113675

  3. Purva3 years ago

    Is there any way to search movie review by movie name?

  4. Steve N.3 years ago

    You'll need to search for the movie with the Movies Search Endpoint
    http://developer.rottentomatoes.com/docs/read/json/v10/Movies_Search
    And then from there, get to the reviews

  5. Quality Challenger3 years ago

    Hi, without the argument for review_type provided (default top_critic, I assume), I receive the following logical error: For the movie given here as a sample, there are 40 reviews. However, on page 2 with page_limit 30, I get only 6 reviews despite the fact that it must be 10.

  6. willyjlyles3 years ago

    Is there a way to get user/audience reviews, rather than critics?

  7. criedl3 years ago

    I would also be interested in reading user/audience reviews rather than critics. Is this possible?

  8. rassar2 years ago

    Hi, sorry to repeat the question but is there a way to get audience reviews using the API?

  9. elizeu2 years ago

    Yes. It would be great to have an option 'audience' to retrieve the audience reviews for a movie. Is there a change this will be available soon?

  10. benlambert187852 years ago

    Hi,

    I was just wondering if there was a way to get the total number of critic reviews for a given movie? I can see that I might be able to do this by counting the number of times the word, 'critic' appears in the returned json, but I was wondering if there was an easier way to do it?

    Many thanks,

    Ben

  11. cflannagan1 year ago

    Also would like to get audience ratings rather than critics. I've found audience ratings to be vastly more reliable gauge of whether I would like movie or not.

  12. KC Kern1 year ago

    Can we get an URL for the critic page? Just going by a name is not an effective way to identify a critic. We need something that can guarantee uniqueness.

    And how about a critic thumbnail? We know you have them.

Please sign in to post a comment.