- Previous: Upcoming DVDs
- Up: API Homepage - v1.0.json
- Next: Movie Cast
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"
}
}
- Previous: Upcoming DVDs
- Up: API Homepage - v1.0.json
- Next: Movie Cast
6 Comments
kunal – 1 year ago
when I do this same call, I get a blank synopsis, is that supposed to happen?
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
anonymustard – 1 year ago
Is there a way to retrieve the number of rotten/fresh reviews and number of user ratings?
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
miweb123 – 3 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
JitenMS – 2 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.