Movies

Movies is the bridge between IMDb's unofficial API; imdbapi.com and Ruby.

Follow me on Twitter or Github for more info and updates.

How to use

Search for a title

Movies.find_by_title("The dark night")

Find movie based on an IMDb id

Movies.find_by_id("tt0337978")

Find by release name

This method will try to filter out as much irrelevant data as possible using this exclude list, before doing a request to the server. It will also try to find a release year in the title, which will be passed to imdbapi.com.

Movies.find_by_release_name("Heartbreaker.2010.LIMITED.DVDRip.XviD-SUBMERGE")

The snippet above will pass the following data to the server.

Movies.find_by_title("Heartbreaker", {
  y: "2010"
})

Settings

You can pass some arguments if you for example want to search for a particular year.

Movies.find_by_title("The dark night", {
  y: "2010"
})

These params are supported.

• y (Any number) Year of the movie.
• plot (short, full) Short or extended plot (short default).
• tomatoes (Boolean) Adds rotten tomatoes data.

Rottentomatoes

movie = Movies.find_by_title("Die Hard 4.0", {
  tomatoes: "true"
})

movie.tomato.meter
# => 82
movie.tomato.image
# => "certified"
movie.tomato.rating
# => 6.8
movie.tomato.reviews
# => 198
movie.tomato.fresh
# => 162
movie.tomato.rotten
# => 36

Data to work with

These accessors are available for the object that is being returned from the find_by_* methods.

• year (Fixnum) Year of the movie.
• released (Date) Release date.
• writers (Array < String >) Writers.
• actors (Array < String>) Actors.
• director (String) Name of director.
• rating (Float) Rating from 1.0 to 10.0.
• votes (Float) Number of votes.
• runtime (Fixnum) Run time in seconds.
• href (String) IMDb url.
• id (String) IMDb id.
• poster (String) Url to poster.
• found? (Boolean) Where anything found?

How to install

[sudo] gem install movies

Requirements

Movies is tested in OS X 10.6.7 using Ruby 1.9.2.

License

Movies is released under the MIT license.