Opening Movies

Retrieves current opening movies

URL

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

Parameters

Example Call and Response

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

{
  "movies": [{
    "id": "770739679",
    "title": "Captain America: The First Avenger",
    "year": 2011,
    "mpaa_rating": "PG-13",
    "runtime": 121,
    "critics_consensus": "With plenty of pulpy action, a pleasantly retro vibe, and a handful of fine performances, Captain America is solidly old-fashioned blockbuster entertainment.",
    "release_dates": {"theater": "2011-07-22"},
    "ratings": {
      "critics_rating": "Fresh",
      "critics_score": 71,
      "audience_score": 96
    },
    "synopsis": "Captain America: The First Avenger will focus on the early days of the Marvel Universe when Steve Rogers (Chris Evans) volunteers to participate in an experimental program that turns him into the Super Soldier known as Captain America. As Captain America, Rogers joins forces with Bucky Barnes (Sebastian Stan) and Peggy Carter (Hayley Atwell) to wage war on the evil HYDRA organization, led by the villainous Red Skull (Hugo Weaving.) -- (C) Paramount",
    "posters": {
      "thumbnail": "http://content9.flixster.com/movie/11/15/83/11158339_mob.jpg",
      "profile": "http://content9.flixster.com/movie/11/15/83/11158339_pro.jpg",
      "detailed": "http://content9.flixster.com/movie/11/15/83/11158339_det.jpg",
      "original": "http://content9.flixster.com/movie/11/15/83/11158339_ori.jpg"
    },
    "abridged_cast": [
      {
        "name": "Chris Evans",
        "characters": [
          "Captain America/Steve Rogers",
          "Steve Rogers / Captain America",
          "Steve Rogers/Captain America"
        ]
      },
      {
        "name": "Hayley Atwell",
        "characters": ["Peggy Carter"]
      },
      {
        "name": "Sebastian Stan",
        "characters": [
          "Bucky Barnes",
          "James Buchanan \"Bucky\" Barnes"
        ]
      },
      {
        "name": "Tommy Lee Jones",
        "characters": ["Colonel Chester Phillips"]
      },
      {
        "name": "Hugo Weaving",
        "characters": [
          "Johann Schmidt/Red Skull",
          "Johann Schmidt/The Red Skull",
          "Red Skull"
        ]
      }
    ],
    "alternate_ids": {"imdb": "0458339"},
    "links": {
      "self": "http://api.rottentomatoes.com/api/public/v1.0/movies/770739679.json",
      "alternate": "http://www.rottentomatoes.com/m/captain-america/",
      "cast": "http://api.rottentomatoes.com/api/public/v1.0/movies/770739679/cast.json",
      "clips": "http://api.rottentomatoes.com/api/public/v1.0/movies/770739679/clips.json",
      "reviews": "http://api.rottentomatoes.com/api/public/v1.0/movies/770739679/reviews.json",
      "similar": "http://api.rottentomatoes.com/api/public/v1.0/movies/770739679/similar.json"
    }
  }],
  "links": {
    "self": "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/opening.json?limit=1&country=us",
    "alternate": "http://www.rottentomatoes.com/movie/opening.php"
  },
  "link_template": "http://api.rottentomatoes.com/api/public/v1.0/lists/movies/opening.json?limit={num_results}&country={country-code}"
}