https://github.com/juzershakir/imdb
A data extraction gem for imdb.com.
https://github.com/juzershakir/imdb
episodes games gem imdb movie movies ruby tv-shows
Last synced: over 1 year ago
JSON representation
A data extraction gem for imdb.com.
- Host: GitHub
- URL: https://github.com/juzershakir/imdb
- Owner: JuzerShakir
- Created: 2023-10-01T06:23:57.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-30T08:26:30.000Z (over 1 year ago)
- Last Synced: 2025-03-12T16:06:35.563Z (over 1 year ago)
- Topics: episodes, games, gem, imdb, movie, movies, ruby, tv-shows
- Language: Ruby
- Homepage: https://rubygems.org/gems/imdb_title
- Size: 199 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
IMDb
[](https://badge.fury.io/rb/imdb_title)
[](https://github.com/JuzerShakir/imdb/actions?query=workflow%3ATests)
[](https://codeclimate.com/github/JuzerShakir/imdb/maintainability)
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][rubydocs].**
- 📢 **[See what's changed in recent versions][changelog].**
[rubydocs]: https://www.rubydoc.info/gems/imdb_title/
[changelog]: CHANGELOG.md
## Getting Started
Start by including `imdb_title` in your Gemfile:
```ruby
gem 'imdb_title'
```
Then run `bundle install`.
or run this command in your console to install gem locally:
```ruby
gem install imdb_title
```
## Usage
### Here's an example
```ruby
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.tagline #=> Over the course of several years, two convicts...
movie.genres #=> ["Drama"]
movie.revenue #=> $28,884,716
movie.ancestors #=> [IMDb::Title, Object, PP::ObjectMixin, ...]
movie.singleton_class.ancestors #=> >, Movie, NonInteractive, IMDb::Title, Object, PP::ObjectMixin, ...]
```
---
### Available Methods
For ALL titles
- title
- tagline
- genres
- ratings
- popularity
- directors
- production_companies
- casts
- release_date
- imdb_id
- url
For ALL titles EXCEPT Game
- duration
Exculsive to Movie
- budget
- revenue
---
### Methods that return
Array
- casts
- genres
- directors
- production_companies
> All other methods will return `string` type.
## Contributing
If you have problems, please create a [GitHub Issue](https://github.com/JuzerShakir/imdb/issues).
Take a look at the [Contributing](CONTRIBUTING.md) 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 .
## License
This code is free to use under the terms of the MIT license.