Skip to main content

API for IMDB, to search for movie and get the details like rating, summary, director, cast etc

Project description

PyPI

Install

pip install IMDBAPI

windows

py -m pip install IMDBAPI

with setup.py

py setup.py install

API

getRating(movieName ):

which returns the rating of the requsted movie by passing Movie Name as a parameter

getRatingByImdbId(IMDB_ID ):

which returns the rating of the requsted movie by IMDB ID as a prameter

getDirector(movieName):

which returns the Directors name of the requsted movie by passing Movie Name as a parameter

getDirectorByImdbId(IMDB_ID ):

which returns the Directors name of the requsted movie by IMDB ID as a prameter

getCasting(movieName, length=10, all=False):

which returns the cast list of the requsted movie by passing Movie Name as a parameter

length: No of castlist which will be returned (default “10”)

all: if set to True returns all the cast list (default “False”)

getCastingByImdbId(IMDB_ID , length=10, all=False):

which returns the cast list of the requsted movie by IMDB ID as a prameter

length: No of castlist which will be returned (default “10”)

all: if set to True returns all the cast list (default “False”)

getSummary(movieName ):

which returns the summary of the requsted movie by passing Movie Name as a parameter

getSummaryByImdbId(IMDB_ID ):

which returns the summary of the requsted movie by IMDB ID as a prameter

getMovie(movieName ):

which returns the an object with data of the requsted movie by passing Movie Name as a parameter (see getMovieByImdbId() for more deatails)

getMovieByImdbId(IMDB_ID ):

which returns the data of the requsted movie by IMDB ID as a prameter, data is as follows

title - Movie full tile
runTime - duration of the movie
titleYear - year of the movie title
releaseDate - date of the movie
gener - gener as an array
posterUrl - url of the movie poster
rating - rating of the movie
summary - summary text
director - name of the director
casting - list of top 10 cast (can be tweaked to print all the casting)

Example

from IMDBAPI import IMDB

imdb = IMDB()

print("Movie rated: "+imdb.getRating('darknight rises')+" out of 10")

Movie: The Dark Knight Rises
Movie rated:  '8.4' out of 10


Sample1.py output: (pretty printed just for viewing)

Enter a movie: darknight rises

Movie: The Dark Knight Rises
Movie Rated: 8.4 out Of 10

Movie: The Dark Knight Rises
Summary: Eight years after the Joker's reign of anarchy, Batman, with the help of the enigmatic Catwoman, is forced from his exile to save Gotham City, now on the edge of total annihilation, from the brutal guerrilla terrorist Bane.

Movie: The Dark Knight Rises
Director: ChristopherNolan

Movie: The Dark Knight Rises
Cast_list size: 10

{
    'actor': 'Christian Bale',
    'role': 'Bruce Wayne'
} {
    'actor': 'Gary Oldman',
    'role': 'Commissioner Gordon'
} {
    'actor': 'Tom Hardy',
    'role': 'Bane'
} {
    'actor': 'Joseph Gordon-Levitt',
    'role': 'Blake'
} {
    'actor': 'Anne Hathaway',
    'role': 'Selina'
} {
    'actor': 'Marion Cotillard',
    'role': 'Miranda'
} {
    'actor': 'Morgan Freeman',
    'role': 'Fox'
} {
    'actor': 'Michael Caine',
    'role': 'Alfred'
} {
    'actor': 'Matthew Modine',
    'role': 'Foley'
} {
    'actor': 'Alon Aboutboul',
    'role': 'Dr. Pavel       (as Alon Moni Aboutboul)'
}


Movie Details:
Movie: The Dark Knight Rises

{
    "title": "The Dark Knight Rises",

    "runTime": "2h44min",

    "titleYear": "2012",

    "releaseDate": "2012-07-20",

    "gener": ["Action", "Thriller"],

    "posterUrl": "https://m.media-amazon.com/images/M/MV5BMTk4ODQzNDY3Ml5BMl5BanBnXkFtZTcwODA0NTM4Nw@@._V1_UX182_CR0,0,182,268_AL__QL50.jpg",

    "rating ": "8.4 ",

    "summary ": "Eight years after the Joker 's reign of anarchy,Batman with the help of the enigmatic Catwoman,is forced from his exile to save Gotham City",

    "director ": "ChristopherNolan ",

    "casting ": [{
        'actor': 'Christian Bale',
            'role': 'Bruce Wayne'
        }, {
            'actor': 'Gary Oldman',
            'role': 'Commissioner Gordon'
        }, {
            'actor': 'Tom Hardy',
            'role': 'Bane'
        }, {
            'actor': 'Joseph Gordon-Levitt',
            'role': 'Blake'
        }, {
            'actor': 'Anne Hathaway',
            'role': 'Selina'
        }, {
            'actor': 'Marion Cotillard',
            'role': 'Miranda'
        }, {
            'actor': 'Morgan Freeman',
            'role': 'Fox'
        }, {
            'actor': 'Michael Caine',
            'role': 'Alfred'
        }, {
            'actor': 'Matthew Modine',
            'role': 'Foley'
        }, {
            'actor': 'Alon Aboutboul',
            'role': 'Dr. Pavel       (as Alon Moni Aboutboul)'
        }
    ]
}

IMDB_ID :

is an unique ID given by IMDB to a movie or series or a celebrity, IMDB_ID can be found in the URL.
if you open IMDB for a movie, say "The Dark night rises" the URL will be "https://www.imdb.com/title/tt1345836/"

this last text "tt1345836" is the IMDB ID of the movie

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
IMDBAPI-1.0.2.tar.gz (5.0 kB) Copy SHA256 hash SHA256 Source None Sep 8, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page