A Ruby wrapper for the The Movie Database API.
Provides a simple, easy to use interface for the Movie Database API.
Get your API key here.
gem install themoviedb
Example usage of the 'themovedb' gem
http://themoviedb.herokuapp.com/
https://github.com/ahmetabdi/themoviedb-example
Tmdb::Api.key("KEY_HERE")
Current available resources:
- Company
- Movie
- Collection
- People
- Genre
Tmdb::Movie.find("batman")
Tmdb::Collection.find("spiderman")
Tmdb::People.find("samuel jackson")
Tmdb::Company.find("lucas")
Tmdb::Genre.find("drama")
resources => person, movie, collection, company
@search = Tmdb::Search.new
@search.resource('person') # determines type of resource
@search.query('samuel jackson') # the query to search against
@search.fetch # makes request
Get the system wide configuration information. Some elements of the API require some knowledge of this configuration data. The purpose of this is to try and keep the actual API responses as light as possible. This method currently holds the data relevant to building image URLs as well as the change key map. To build an image URL, you will need 3 pieces of data. The base_url, size and file_path. Simply combine them all and you will have a fully qualified URL. Here’s an example URL: http://cf2.imgobject.com/t/p/w500/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg
configuration = Tmdb::Configuration.new
configuration.base_url
configuration.secure_base_url
configuration.poster_sizes
configuration.backdrop_sizes
configuration.profile_sizes
configuration.logo_sizes
Every movie example documented below uses the movie Fight Club (id 550) while every person uses Brad Pitt (id 287). These are only used as examples to show what a real world request looks like.
movie = Tmdb::Movie.detail(550)
movie.adult => false
movie.backdrop_path => "/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg"
movie.belongs_to_collection => nil
movie.budget => 63000000
movie.genres => [{"id"=>28, "name"=>"Action"}, {"id"=>18, "name"=>"Drama"}, {"id"=>53, "name"=>"Thriller"}]
movie.homepage => ""
movie.id => 550
movie.imdb_id => "tt0137523"
movie.original_title => "Fight Club"
movie.overview => "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion."
movie.popularity => 7.4
movie.poster_path => "/2lECpi35Hnbpa4y46JX0aY3AWTy.jpg"
movie.production_companies => [{"name"=>"20th Century Fox", "id"=>25}, {"name"=>"Fox 2000 Pictures", "id"=> 711}, {"name"=>"Regency Enterprises", "id"=>508}]
movie.production_countries => [{"iso_3166_1"=>"DE", "name"=>"Germany"}, {"iso_3166_1"=>"US", "name"=>"United States of America"}]
movie.release_date => "1999-10-14"
movie.revenue => 100853753
movie.runtime => 139
movie.spoken_languages => [{"iso_639_1"=>"en", "name"=>"English"}]
movie.status => "Released"
movie.tagline => "How much can you know about yourself if you've never been in a fight?"
movie.title => "Fight Club"
movie.vote_average => 8.8
movie.vote_count => 234
Get the latest movie id.
Tmdb::Movie.latest
Get the list of upcoming movies. This list refreshes every day. The maximum number of items this list will include is 100.
Tmdb::Movie.upcoming
Get the list of movies playing in theatres. This list refreshes every day. The maximum number of items this list will include is 100.
Tmdb::Movie.now_playing
Get the list of popular movies on The Movie Database. This list refreshes every day.
Tmdb::Movie.popular
Get the list of top rated movies. By default, this list will only include movies that have 10 or more votes. This list refreshes every day.
Tmdb::Movie.top_rated
Get the alternative titles for a specific movie id.
Tmdb::Movie.alternative_titles(22855)
Get the images (posters and backdrops) for a specific movie id.
Tmdb::Movie.images(22855)
Get the cast information for a specific movie id.
Tmdb::Movie.casts(22855)
Get the plot keywords for a specific movie id.
Tmdb::Movie.keywords(22855)
Get the release date by country for a specific movie id.
Tmdb::Movie.releases(22855)
Get the trailers for a specific movie id.
Tmdb::Movie.trailers(22855)
Get the translations for a specific movie id.
Tmdb::Movie.translations(22855)
Get the similar movies for a specific movie id.
Tmdb::Movie.similar_movies(22855)
Get the lists that the movie belongs to.
Tmdb::Movie.lists(22855)
Get the changes for a specific movie id.
Tmdb::Movie.changes(22855)
company = Tmdb::Company.detail(1)
company.id => 1
company.description => nil
company.homepage => "http://www.lucasfilm.com"
company.logo_path => "/8rUnVMVZjlmQsJ45UGotDOUznxj.png"
company.name => "Lucasfilm"
company.parent_company => nil
Get the list of movies associated with a particular company.
Tmdb::Company.movies(1)
collection = Tmdb::Collection.detail(51845)
collection.id => 51845
collection.backdrop_path => "..."
collection.parts => "..."
collection.poster_path => "..."
collection.name => "DC Universe Animated Original Movies"
Get all of the images for a particular collection by collection id.
Tmdb::Collection.images(51845)
people = Tmdb::People.detail(287)
people.id => 287
people.name => "Brad Pitt"
people.place_of_birth => "Shawnee, Oklahoma, United States"
people.also_known_as => []
people.adult => false
people.biography => "From Wikipedia, the free"..
people.birthday => "1963-12-18"
people.deathday => ""
people.homepage => "http://simplybrad.com/"
people.profile_path => "w8zJQuN7tzlm6FY9mfGKihxp3Cb.jpg"
Get the list of popular people on The Movie Database. This list refreshes every day.
Tmdb::People.popular
Get the latest person id.
Tmdb::People.latest
Get the credits for a specific person id.
Tmdb::People.credits(287)
Get the images for a specific person id.
Tmdb::People.images(287)
Get the changes for a specific person id.
Tmdb::People.changes(287)
genre = Tmdb::Genre.detail(18)
genre.id => 18
genre.name => "Drama"
genre.page => 1
genre.total_pages => 45
genre.total_results => 883
genre.results => [...]
genre.get_page(page_number) => Returns next set of movies.
Get a list of all genres.
Tmdb::Genre.list