From the link_template, you know that the endpoint can take in two parameters, limit and country.
The rest of the endpoints should also have link_templates to help determine what options/parameters are available to each. I like to think of it as self documentation, so you don't necessarily have to flip through our api docs to figure out what the endpoint's options/parameters are.
Ah, thank you! - I didn't see the link_template. The limit parameter worked :)
One thing I noticed is the year is wrong for some movies and is either a year higher or lower than reality. Guess that's not related to the API but where do I file such bugs?
Hey Hackeron,
We have a help desk where you can submit comments like this: http://www.rottentomatoes.com/help_desk/
I'm a bit curious though, what's a year off that you see? I've seen something similar, but it wasn't actually "off". It was a movie that had its preview at a film festival one year, and a wide release the next year. So the movie year given on Rotten Tomatoes as the year it previewed at a film festival, not the wide release year.
Hmm, quite often the year is 1 or 2 years ahead or behind. For instance all these appear to be wrong:
"Battle Los Angeles 2010" - should be 2011
"The Other Woman 2011" - should be 2009
"Peep World 2011" - should be 2010
"Cracks 2011" - should be 2009
"HappyThankYouMorePlease 2011" - should be 2010
"Even the Rain 2011" - should be 2010
"American The Bill Hicks Story 2011" - should be 2009
Interesting. This is pure speculation on my part (does not reflect the views of my employer, yada yada), but there seems to be disagreement between different movie info providers on what year to use. Do you use the year it was first shown (like at a film festival)? Do you use when it was finished for production (not released yet)? Do you use the limited release date or the wide release date?
Anyway, in the examples you gave:
The Other Woman - wikipedia says "post-production wrapped in 2009, the movie was shelved until 2011", imdb says 2009, rotten tomatoes says 2011
Peep World - it was shown in the 2010 Austin Film Festival, but then released to the wider audience in 2011
Cracks - was first shown at film festivals in 2009, before coming to the US for a limited release in 2011
happythankyoumoreplease - Sundance film festival 2010, then 2011 limited release
The dates for Rotten Tomatoes appear to be more US-centric, probablye because they're based primarily in the US. I'm not saying they're right or wrong, just giving reasons for the difference in years.
I'm trying to use /api/public/v1.0/lists/dvds/top_rentals.json
I tried passing the page parameter or the page_limit parameter - but no matter what I do, I just get a list of the top 10 rentals :/
Message edited by Hackeron 2 years ago
Tags
Steve N. – 2 years ago
Hi Hackeron,
The documentation needs some attention. We'll try to polish it up this weekend. In the meanwhile, I put up the documentation for top_rentals here: http://developer.rottentomatoes.com/docs/read/json/v10/Top_Rentals
You'll need to use the limit parameter to affect how many top rentals are shown. For example: http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit=50&apikey=[your api key]
The link_template in the JSON response is also very helpful in figuring out what parameters are available. For that specific endpoint, the link_template was: http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit={num-results}&country={country-code}
From the link_template, you know that the endpoint can take in two parameters, limit and country.
The rest of the endpoints should also have link_templates to help determine what options/parameters are available to each. I like to think of it as self documentation, so you don't necessarily have to flip through our api docs to figure out what the endpoint's options/parameters are.
Hackeron – 2 years ago
Ah, thank you! - I didn't see the link_template. The limit parameter worked :)
One thing I noticed is the year is wrong for some movies and is either a year higher or lower than reality. Guess that's not related to the API but where do I file such bugs?
Steve N. – 2 years ago
Hey Hackeron, We have a help desk where you can submit comments like this: http://www.rottentomatoes.com/help_desk/ I'm a bit curious though, what's a year off that you see? I've seen something similar, but it wasn't actually "off". It was a movie that had its preview at a film festival one year, and a wide release the next year. So the movie year given on Rotten Tomatoes as the year it previewed at a film festival, not the wide release year.
Hackeron – 2 years ago
Hmm, quite often the year is 1 or 2 years ahead or behind. For instance all these appear to be wrong:
"Battle Los Angeles 2010" - should be 2011 "The Other Woman 2011" - should be 2009 "Peep World 2011" - should be 2010 "Cracks 2011" - should be 2009 "HappyThankYouMorePlease 2011" - should be 2010 "Even the Rain 2011" - should be 2010 "American The Bill Hicks Story 2011" - should be 2009
etc...
Why is this? :(
Steve N. – 2 years ago
Interesting. This is pure speculation on my part (does not reflect the views of my employer, yada yada), but there seems to be disagreement between different movie info providers on what year to use. Do you use the year it was first shown (like at a film festival)? Do you use when it was finished for production (not released yet)? Do you use the limited release date or the wide release date?
Anyway, in the examples you gave: The Other Woman - wikipedia says "post-production wrapped in 2009, the movie was shelved until 2011", imdb says 2009, rotten tomatoes says 2011
Peep World - it was shown in the 2010 Austin Film Festival, but then released to the wider audience in 2011
Cracks - was first shown at film festivals in 2009, before coming to the US for a limited release in 2011
happythankyoumoreplease - Sundance film festival 2010, then 2011 limited release
The dates for Rotten Tomatoes appear to be more US-centric, probablye because they're based primarily in the US. I'm not saying they're right or wrong, just giving reasons for the difference in years.