Upcoming Movies

Retrieves upcoming movies. Results are paginated if they go past the specified page limit

URL

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

Parameters

Example Call and Response

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

{
  "total": 29,
  "movies": [{
    "id": "770863875",
    "title": "Cowboys and Aliens",
    "year": 2011,
    "mpaa_rating": "PG-13",
    "runtime": "",
    "release_dates": {"theater": "2011-07-29"},
    "ratings": {
      "critics_score": -1,
      "audience_score": 94
    },
    "synopsis": "1875. New Mexico Territory. A stranger (Craig) with no memory of his past stumbles into the hard desert town of Absolution. What he discovers is that the people of Absolution don't welcome strangers, and nobody makes a move on its streets unless ordered to do so by the iron-fisted Colonel Dolarhyde (Ford). It's a town that lives in fear.  But Absolution is about to experience fear it can scarcely comprehend as the desolate city is attacked by marauders from the sky. Now, the stranger they rejected is their only hope for salvation. As this gunslinger slowly starts to remember who he is and where he's been, he realizes he holds a secret that could give the town a fighting chance against the alien force. -- (C) Official Site",
    "posters": {
      "thumbnail": "http://content8.flixster.com/movie/11/15/42/11154270_mob.jpg",
      "profile": "http://content8.flixster.com/movie/11/15/42/11154270_pro.jpg",
      "detailed": "http://content8.flixster.com/movie/11/15/42/11154270_det.jpg",
      "original": "http://content8.flixster.com/movie/11/15/42/11154270_ori.jpg"
    },
    "abridged_cast": [
      {
        "name": "Daniel Craig",
        "characters": ["Zeke Jackson"]
      },
      {
        "name": "Olivia Wilde",
        "characters": [
          "Ella",
          "Ella Swenson"
        ]
      },
      {
        "name": "Harrison Ford",
        "characters": [
          "Colonel Dolarhyde",
          "Woodrow Dolarhyde"
        ]
      },
      {
        "name": "Sam Rockwell",
        "characters": ["Doc"]
      },
      {
        "name": "Paul Dano",
        "characters": [
          "Percy",
          "Percy Dollarhyde"
        ]
      }
    ],
    "alternate_ids": {"imdb": "0409847"},
    "links": {
      "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/770863875.json",
      "alternate": "http://www.rottentomatoes.com/m/cowboys_and_aliens/",
      "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/770863875/cast.json",
      "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/770863875/clips.json",
      "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/770863875/reviews.json",
      "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/770863875/similar.json"
    }
  }],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/upcoming.json?page_limit=1&country=us&page=1",
    "next": "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/upcoming.json?page_limit=1&country=us&page=2",
    "alternate": "http://www.rottentomatoes.com/movie/upcoming.php"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/upcoming.json?page_limit={results_per_page}&page={page_number}&country={country-code}"
}