https://github.com/santhoshse7en/imdby
imdby is a Python package useful to retrieve and manage the data of the IMDb movie database about movies, people, characters and companies.
https://github.com/santhoshse7en/imdby
beautifulsoup4 bs4 characters imdb imdb-api imdb-movie imdb-movie-database imdb-movies imdb-webscrapping movies pandas pypi python scrapers sys time without-api
Last synced: 3 days ago
JSON representation
imdby is a Python package useful to retrieve and manage the data of the IMDb movie database about movies, people, characters and companies.
- Host: GitHub
- URL: https://github.com/santhoshse7en/imdby
- Owner: santhoshse7en
- License: mit
- Created: 2019-05-21T02:21:01.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-05-08T04:03:07.000Z (about 1 month ago)
- Last Synced: 2025-06-07T04:36:34.051Z (11 days ago)
- Topics: beautifulsoup4, bs4, characters, imdb, imdb-api, imdb-movie, imdb-movie-database, imdb-movies, imdb-webscrapping, movies, pandas, pypi, python, scrapers, sys, time, without-api
- Language: Python
- Homepage: https://santhoshse7en.github.io/imdby/
- Size: 594 KB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://pypi.org/project/imdby)
[](https://pypi.python.org/pypi/imdby/)
[](https://santhoshse7en.github.io/imdby_doc)
[](https://pepy.tech/project/imdby)
# 🎬 imdby
**imdby** is a Python package designed to retrieve and manage data from the [IMDb](https://www.imdb.com/) database — including information about movies, people, characters, companies, events, and news.
---
## 🔗 Project Links
| Resource | Link |
| ---------------- | -------------------------------------------------------- |
| 🐍 PyPI | [imdby on PyPI](https://pypi.org/project/imdby/) |
| 🛠 Repository | [GitHub Repo](https://github.com/santhoshse7en/imdby/) |
| 📚 Documentation | [imdby Docs](https://santhoshse7en.github.io/imdby_doc/) |
---
## 🚀 Features
* Retrieve and manage comprehensive IMDb data: movies, people, characters, companies, and more.
* Perform sentiment analysis on IMDb user reviews using **VADER** and **TextBlob**.
* Compatible with **Python 3** (and backward-compatible with **Python 2.7**).
* Platform-independent and supports both web scraping and local database querying.
* Clean and easy-to-use API.
---
## 📦 Dependencies
* `beautifulsoup4`
* `selenium`
* `chromedriver-binary`
* `vaderSentiment`
* `textblob`
* `pandas`
---
## 📥 Installation
Install from the GitHub repository (recommended for the latest updates):
```bash
pip install git+https://github.com/santhoshse7en/imdb
```
Or install the latest release from PyPI:
```bash
pip install imdby
```
---
## ✨ Quick Start
Here's a quick example of how to use **imdby**:
```python
from imdb.imdb import IMDb
# Create an instance
ia = IMDb()
# Fetch full cast and crew of a movie by IMDb ID
cast = ia.full_cast_and_crew('tt4154796')
# Print the directors
print('Directors:')
for director in cast.directors:
print(director)
# Search for a person
people = ia.search_person('Simon Baker')
print(people.person_id, people.person_name)
```
---
## 🆘 Getting Help
For comprehensive usage guides and API reference, check out the [official documentation](https://imdby.readthedocs.io/).
---
## 🤝 Contributing
We welcome contributions!
If you're planning a significant change, please open an issue first to discuss your ideas.
Make sure to update or add relevant tests.
---
## 👥 Contributors
Big thanks to all the contributors who help make **imdby** better:
* **Sai Harsha Kurapati** – [@harshasic](https://github.com/harshasic)
Want to contribute? Fork the repo and send a pull request!
---
## 📄 License
This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).