New Release 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/new_releases.json?apikey=[your_api_key]

Parameters

ParameterRequiredDefaultDescription
page_limit false 16 The amount of new release dvds to show per page
page false 1 The selected page of new release DVDs
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/new_releases.json?apikey=[your_api_key]&page_limit=1

{
  "total": 50,
  "movies": [{
    "id": "771036677",
    "title": "Limitless",
    "year": 2011,
    "mpaa_rating": "PG-13",
    "runtime": 105,
    "critics_consensus": "Although its script is uneven, Neil Burger directs Limitless with plenty of visual panache, and Bradley Cooper makes for a charismatic star.",
    "release_dates": {
      "theater": "2011-03-18",
      "dvd": "2011-07-19"
    },
    "ratings": {
      "critics_rating": "Fresh",
      "critics_score": 70,
      "audience_rating": "Upright",
      "audience_score": 74
    },
    "synopsis": "Aspiring author Eddie Morra (Cooper) is suffering from chronic writer's block, but his life changes instantly when an old friend introduces him to NZT, a revolutionary new pharmaceutical that allows him to tap his full potential. Soon Eddie takes Wall Street by storm, parlaying a small stake into millions. His accomplishments catch the eye of mega-mogul Carl Van Loon (De Niro),who invites him to help broker the largest merger in corporate history. But they also bring Eddie to the attention of people willing to do anything to get their hands on his stash of NZT. With his life in jeopardy and the drug's brutal side effects grinding him down, Eddie dodges mysterious stalkers, a vicious gangster and an intense police investigation as he attempts to hang on to his dwindling supply long enough to outwit his enemies.-- (C) Relativity",
    "posters": {
      "thumbnail": "http://content6.flixster.com/movie/11/15/61/11156184_mob.jpg",
      "profile": "http://content6.flixster.com/movie/11/15/61/11156184_pro.jpg",
      "detailed": "http://content6.flixster.com/movie/11/15/61/11156184_det.jpg",
      "original": "http://content6.flixster.com/movie/11/15/61/11156184_ori.jpg"
    },
    "abridged_cast": [
      {
        "name": "Bradley Cooper",
        "characters": ["Eddie Morra"]
      },
      {
        "name": "Robert De Niro",
        "characters": ["Carl Van Loon"]
      },
      {
        "name": "Abbie Cornish",
        "characters": ["Lindy"]
      },
      {
        "name": "Andrew Howard",
        "characters": ["Gennady"]
      },
      {
        "name": "Anna Friel",
        "characters": ["Melissa"]
      }
    ],
    "alternate_ids": {"imdb": "1219289"},
    "links": {
      "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036677.json",
      "alternate": "http://www.rottentomatoes.com/m/limitless/",
      "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036677/cast.json",
      "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036677/clips.json",
      "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036677/reviews.json",
      "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/771036677/similar.json"
    }
  }],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/new_releases.json?page_limit=1&country=us&page=1",
    "next": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/new_releases.json?page_limit=1&country=us&page=2",
    "alternate": "http://www.rottentomatoes.com/dvd/new_releases.php"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/new_releases.json?page_limit={results-per-page}&page={page-number}&country={country-code}"
}

version 4 as of 2 years ago by Steve N.

4 Comments

  1. Hackeron – 2 years ago

    There seems to be no documentation for: /api/public/v1.0/lists/dvds/top_rentals.json

    I'm trying to do:

    1. http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?page=2&apikey=mykey

    But it's returning the first page and only 15 results.

    I tried to use page_limit=50 or tried to go through pages with page=2, page=3 - but it's still just returning the top 15 rentals no matter what I try :(

    Any ideas?

  2. Hackeron – 2 years ago

    Sorry, I meant it returns the top 10 results, not 15

  3. Steve N. – 2 years ago

    Hi Hackeron, Try this: http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit=50 This will give the 50 top rentals results.

    Another helpful hint on the api, you'll notice that there's a link_template attribute in each of the response that gives you a template on what other parameters are available. In the case of the top_rentals endpoint, its link_template is: http://api.rottentomatoes.com/api/public/v1.0/lists/dvds/top_rentals.json?limit={num-results}&country={country-code}

    With that, you know that there are two parameters that you can change, limit and country.

    Back to your original point - yes, the documentation needs some attention. We'll try to polish it up this weekend. If you have any other questions or comments, make sure to head to our forums. http://developer.rottentomatoes.com/forum

    Your questions will get better visibility and possibly help other people.

    Thanks!

  4. willemk – 2 years ago

    Is there any way to order these?

Please sign in to post a comment.