https://github.com/oleander/imdb_lists

Get easy access to any public IMDb list using Ruby
https://github.com/oleander/imdb_lists

Last synced: about 2 months ago
JSON representation

Get easy access to any public IMDb list using Ruby

• Host: GitHub
• URL: https://github.com/oleander/imdb_lists
• Owner: oleander
• Created: 2011-02-27T17:32:29.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2011-09-23T11:40:35.000Z (over 13 years ago)
• Last Synced: 2024-04-25T19:21:16.334Z (9 months ago)
• Language: Ruby
• Homepage: https://github.com/oleander/imdb_vote_history
• Size: 590 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# IMDb Lists

Get easy access to any public [IMDb](http://www.imdb.com/) [movie list](http://www.imdb.com/lists).

## How to use

### Find by url

``` ruby

require "imdb_lists"

result = ImdbLists.fetch("http://www.imdb.com/user/ur10777143/ratings")

result.movies.count # => 693

result.movies.first.title # => Die Hard

```

## Data to work with

### Accessors

 

- **name** (String) List name.

- **url** (String) Full URL to the IMDb list itself.

- **movies** (Array) A list of movies.

- **csv** (String) Url to movie CSV file.

### A movie object

The `movies` method returns a list of movies.

 

- **id** (String) IMDb movie id.

- **title** (String) Movie title.

- **directors** (Array< String >) A list of directors.

- **rating** (Fixnum) Movie rating, from 0.0 to 10.0.

- **runtime** (Fixnum) Runtime in minutes.

- **genres** (Array< String >) A list of genres.

- **votes** (Fixnum) The amount of votes.

- **released_at** (Time) When was the movie released?

- **details** (String) Url to a [IMDb details](http://www.imdb.com/title/tt0095016/) page.

- **created_at** (Time) When was it added to the given list?

- **order** (Fixnum) Where is the movie?

 

#### Only for [vote lists](http://www.imdb.com/user/ur10777143/ratings)

- **you_rated** (Fixnum) Your rating, from 0.0 to 10.0.

 

## How do install

    [sudo] gem install imdb_lists

    

## How to use it in a rails 3 project

Add `gem 'imdb_lists'` to your Gemfile and run `bundle`.

## Requirements

*IMDb Lists* is tested in OS X 10.6.6, 10.7.1 using Ruby 1.9.2.

## License

*IMDb Lists* is released under the MIT license.