ruby interface for the netflix api
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.document
.gitignore
LICENSE
README.rdoc
Rakefile
VERSION
flix4r.gemspec
init.rb

README.rdoc

Flix4r

a ruby client for the NetFlix API

this is a gemification of the google code project found here: “code.google.com/p/flix4r/”

Based on the “RESTful” resources provided by the NetFlix API, flix4r provides a clean, if very incomplete, set of models for accessing NetFlixs' (sp?) resources.

Credentials

You must add your netflix credentials to flix4r/lib/oauth.yml. You can get credentials from developer.netflix.com/.

Example Usage

>> list = NetFlix::Title.search(:term => 'sneakers', :max_results => 2)
=> [#<NetFlix::Title:0x57f0f58 ...>, #<NetFlix::Title:0x57f0f58 ...>] # shortened for readability
>> sneakers = list.first
>> sneakers.title
=> "Sneakers"

>> sneakers.delivery_formats
=> ['instant', 'DVD']

>> sneakers.id
=> "http://api.netflix.com/catalog/titles/movies/60031755"

>> sneakers.web_page
=> "http://www.netflix.com/Movie/Sneakers/60031755"

>> sneakers.genres
=> ["Thrillers", "Action Comedies", "Espionage Thrillers", "Action Thrillers", "Suspense", "Heist Films", "Universal Studios Home Entertainment"]

>> sneakers.actors
=> ["Robert Redford", "Sidney Poitier", "Ben Kingsley", "Dan Aykroyd", "Mary McDonnell", "River Phoenix", "David Strathairn", "Donal Logue", "Timothy Busfield", "Eddie Jones", "George Hearn", "Lee Garlington", "Stephen Tobolowsky"]

Movie Retrival

more data on each title is available through the NetFlix::Title#movie method. continuing the above example:

>> sneakers.movie.synopsis
=> "Shadowy U.S. intelligence agents blackmail <a href=\"http://www.netflix.com/RoleDisplay/Robert_Redford/76851\">Robert Redford</a> and his eccentric team of security experts into stealing a code-breaking \"black box\" from a Soviet-funded genius. But Redford uncovers a bigger conspiracy, and he and his \"sneakers\" (<a href=\"http://www.netflix.com/RoleDisplay/Sidney_Poitier/74185\">Sidney Poitier</a>, <a href=\"http://www.netflix.com/RoleDisplay/Dan_Aykroyd/4025\">Dan Aykroyd</a>, <a href=\"http://www.netflix.com/RoleDisplay/River_Phoenix/73423\">River Phoenix</a> and <a href=\"http://www.netflix.com/RoleDisplay/David_Strathairn/89582\">David Strathairn</a>) must save themselves and the world economy by stealing the box back from the blackmailers."

Instalation

The gem is on gemcutter. gemcutter.org/gems/flix4r

NetFlix vs Netflix

The great Panda has pointed out to me that the official name is Netflix. meh.= flix4r