Usage
All methods are called on an IMDb() instance:
from imdb.imdb import IMDb
ia = IMDb()Searching (interactive — resolves a name to an IMDb ID)
Search methods print up to 20 numbered suggestions to the console and use input() to read your selection.
| Method | Returns (key attributes) |
|---|---|
search_movie(text) | .title_name, .title_id |
search_person(text) | .name, .person_id |
search_company(text) | .company_name, .company_id |
search_event(text) | .event_name, .event_id |
search_character(text) | .character_name, .character_id |
search_news(text) | .news_title, .news_id |
Title details (take a title_id, e.g. 'tt4154796')
| Method | Data |
|---|---|
movie(title_id) | Title, rating, votes, genres, metascore, budget/gross, storyline |
plot(title_id) | Plot summary and synopsis |
plot_keywords(title_id) | Plot keyword list |
taglines(title_id) | Taglines list |
full_cast_and_crew(title_id) | Directors, writers, cast, producers, music, cinematography, editing, casting |
company(title_id) | Production companies, distributors, special effects, other companies |
release_info(title_id) | Release dates by country, India release date, "Also Known As" titles |
ratings(title_id) | Rating breakdown by demographic and region |
parental_guide(title_id) | MPAA rating, certificates, and content advisories (nudity, violence, profanity, alcohol, frightening, spoilers) |
technical_spec(title_id) | Runtime, sound mix, color, aspect ratio, camera, film format |
critic_reviews(title_id) | Critic review scores and summaries |
external_reviews(title_id) | Links to external critic reviews |
external_sites(title_id) | Official sites, miscellaneous sites, photos, video links |
user_reviews(title_id, remove_spoiler) | User reviews with per-review and aggregate sentiment scores (uses Selenium/Chrome) |
Charts and listings (no arguments)
| Method | Data |
|---|---|
imdb_charts() | Top 250, Top 250 (English), Bottom 100, box office, MovieMeter, Top TV, TVMeter |
top_india_charts() | Top rated Indian, Tamil, Telugu, and Malayalam movies |
trending_now_in_india() | Upcoming, popular Tamil/Telugu/India/global/Hindi titles |
upcoming_releases() | Interactive: pick a region, then lists upcoming releases there |
Notes
user_reviews(title_id, remove_spoiler)uses Selenium to load additional review pages, and requires a local Google Chrome install — the matching chromedriver is downloaded automatically by Selenium's built-in Selenium Manager, so no separate driver package is needed.- Chart and listing methods (
imdb_charts(),top_india_charts(),trending_now_in_india()) returnpandasDataFrames; title and search methods return plain Python objects with named attributes.