IMDb

Want to extract useful information about your favorite Movies, TV shows, Episodes, and Games? Look no further than our data extraction library! All the information you need is a method call away.

Quick links

• 📖 Read the documentation for the latest version.
• 📢 See what's changed in recent versions.

Getting Started

Start by including imdb_title in your Gemfile:

gem 'imdb_title'

Then run bundle install.

Usage

require 'imdb_title'

# input a valid URL of any Movie, Tv-Show, Episode or Game from imdb.com
movie = IMDb::Title.new("https://www.imdb.com/title/tt0111161")

movie.title                 #=> The Shawshank Redemption
movie.budget                #=> $25,000,000
movie.casts.first(2)        #=> ["Tim Robbins", "Morgan Freeman"]
movie.directors             #=> ["Frank Darabont"]
movie.duration              #=> 2 hours 22 minutes
movie.genres                #=> ["Drama"]
movie.imdb_id               #=> tt0111161
movie.popularity            #=> 2.8M
movie.production_companies  #=> ["Castle Rock Entertainment"]
movie.ratings               #=> 9.3
movie.release_date          #=> October 14, 1994 (India)
movie.revenue               #=> $28,884,716
movie.tagline               #=> Over the course of several years, two convicts...

These will return an array type:

1. casts
2. production_companies
3. directors
4. genres

All other methods will return string type.

If any of the following features are not available or mentioned on IMDb for that particular title then it will return nil.

Contributing

If you have problems, please create a GitHub Issue.

Take a look at the Contributing document for instructions on setting up the repo on your machine, understanding the codebase, and creating a good pull request.

Thank you, contributors!

Versioning

ImdbTitle follows Semantic Versioning 2.0 as defined at https://semver.org.

License

This code is free to use under the terms of the MIT license.