- Previous: Movie Clips
- Up: API Homepage - v1.0.json
- Next: Movie Similar
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
| Parameter | Required | Default | Description |
|---|---|---|---|
| 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}"
}
- Previous: Movie Clips
- Up: API Homepage - v1.0.json
- Next: Movie Similar
10 Comments
anonymustard – 2 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)
Steve N. – 2 years ago
Hi anonymustard, Not currently. I've added your request to the Feature Request Forum. http://developer.rottentomatoes.com/forum/read/113675
Purva – 2 years ago
Is there any way to search movie review by movie name?
Steve N. – 2 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
Quality Challenger – 2 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.
willyjlyles – 2 years ago
Is there a way to get user/audience reviews, rather than critics?
criedl – 1 year ago
I would also be interested in reading user/audience reviews rather than critics. Is this possible?
rassar – 1 year ago
Hi, sorry to repeat the question but is there a way to get audience reviews using the API?
elizeu – 12 months 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?
benlambert18785 – 4 months 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
Please sign in to post a comment.