Top Rentals

Retrieves the current top dvd rentals

URL

http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?apikey=[your_api_key]

Parameters

ParameterRequiredDefaultDescription
limit false 10 Limits the number of top rentals returned
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/lists/dvds/top_rentals.json?apikey=[your_api_key]&limit=1

{
  "movies": [{
    "id": "770860165", 
    "title": "True Grit",
    "year": 2010,
    "mpaa_rating": "PG-13",
    "runtime": 110,
    "critics_consensus": "Girded by strong performances from Jeff Bridges, Matt Damon, and newcomer Hailee Steinfeld, and lifted by some of the Coens' most finely tuned, unaffected work, True Grit is a worthy companion to the Charles Portis book.",
    "release_dates": {
      "theater": "2010-12-22",
      "dvd": "2011-06-07"
    },
    "ratings": {
      "critics_rating": "Certified Fresh",
      "critics_score": 96,
      "audience_rating": "Upright",
      "audience_score": 86
    },
    "synopsis": "Fourteen-year-old Mattie Ross (Hailee Steinfeld) joins an aging U.S. marshal (Jeff Bridges) and another lawman (Matt Damon) in tracking her father's killer into hostile Indian territory in Joel and Ethan Coen's adaptation of Charles Portis' original novel. Sticking more closely to the source material than the 1969 feature adaptation starring Western icon John Wayne, the Coens' True Grit tells the story from the young girl's perspective, and re-teams the celebrated filmmaking duo with their No Country for Old Men producing partner Scott Rudin. Josh Brolin and Barry Pepper co-star. ~ Jason Buchanan, Rovi",
    "posters": {
      "thumbnail": "http://content7.flixster.com/movie/11/15/34/11153437_mob.jpg",
      "profile": "http://content7.flixster.com/movie/11/15/34/11153437_pro.jpg",
      "detailed": "http://content7.flixster.com/movie/11/15/34/11153437_det.jpg",
      "original": "http://content7.flixster.com/movie/11/15/34/11153437_ori.jpg"
    },
    "abridged_cast": [
      {
        "name": "Jeff Bridges",
        "characters": ["Rooster Cogburn"]
      },
      {
        "name": "Josh Brolin",
        "characters": [
          "Tom Chane",
          "Tom Chaney"
        ]
      },
      {
        "name": "Matt Damon",
        "characters": ["LaBoeuf"]
      },
      {
        "name": "Hailee Steinfeld",
        "characters": ["Mattie Ross"]
      },
      {
        "name": "Barry Pepper",
        "characters": [
          "\"Lucky\" Ned Pepper",
          "Lucky Ned Pepper"
        ]
      }
    ],
    "alternate_ids": {"imdb": "1403865"},
    "links": {
      "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/770860165.json",
      "alternate": "http://www.rottentomatoes.com/m/true-grit-2010/",
      "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/770860165/cast.json",
      "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/770860165/clips.json",
      "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/770860165/reviews.json",
      "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/770860165/similar.json"
    }
  }],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit=1&country=us",
    "alternate": "http://www.rottentomatoes.com/dvd/top_rentals.php"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit={num-results}&country={country-code}"
}