Upcoming DVDs

Retrieves new release dvds. Results are paginated if they go past the specified page limit

URL

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

Parameters

Example Call and Response

http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/upcoming.json?apikey=[your_api_key]&page_limit=1

{
  "total": 35,
  "movies": [{
    "id": "771036318",
    "title": "Oranges And Sunshine",
    "year": 2010,
    "mpaa_rating": "Unrated",
    "runtime": 105,
    "release_dates": {"dvd": "2011-07-25"},
    "ratings": {
      "critics_rating": "Fresh",
      "critics_score": 78,
      "audience_score": 64
    },
    "synopsis": "Oranges and Sunshine tells the story of Margaret Humphreys (Emily Watson), a social worker from Nottingham, who uncovered one of the most significant social scandals of recent times; the mass deportation of children from the United Kingdom to Australia. Single-handedly and against overwhelming odds, Margaret reunited thousands of families and drew worldwide attention to an extraordinary miscarriage of justice. Children as young as four had been told that their parents were dead and sent to children's homes on the other side of the world, where many were subjected to appalling abuse. These forgotten children were promised Oranges and Sunshine but they got hard labour and life in institutions. -- (C) Icon",
    "posters": {
      "thumbnail": "http://content7.flixster.com/movie/11/12/38/11123877_mob.jpg",
      "profile": "http://content7.flixster.com/movie/11/12/38/11123877_pro.jpg",
      "detailed": "http://content7.flixster.com/movie/11/12/38/11123877_det.jpg",
      "original": "http://content7.flixster.com/movie/11/12/38/11123877_ori.jpg"
    },
    "abridged_cast": [
      {"name": "Hugo Weaving"},
      {"name": "David Wenham"},
      {"name": "Emily Watson"},
      {"name": "Tara Morice"},
      {"name": "Helen Grayson"}
    ],
    "alternate_ids": {"imdb": "1438216"},
    "links": {
      "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036318.json",
      "alternate": "http://www.rottentomatoes.com/m/oranges_and_sunshine/",
      "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036318/cast.json",
      "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036318/clips.json",
      "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036318/reviews.json",
      "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036318/similar.json"
    }
  }],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/upcoming.json?page_limit=1&country=us&page=1",
    "next": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/upcoming.json?page_limit=1&country=us&page=2",
    "alternate": "http://www.rottentomatoes.com/dvd/upcoming.json"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/upcoming.json?page_limit={results-per-page}&page={page-number}&country={country-code}"
}