Ruby bindings for IMDb using imdbapi.com as source
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
Gemfile
README.md
Rakefile
movies.gemspec

README.md

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.