Skip to main content

Wrapper to get movie, series, episode data from the Open Movie Database (OMDb) api.

Project description

omdbapi python library.

Build Status Updates Python 3 codecov

Python lib to get movie, series, episode data from the Open Movie Database (OMDb) api. Example build and distribution python projects - Pytools course.

Used The Open Movie Database api to build a python lib and distribution in pypi.

How to use?

IMPORTANT: Requires Python 3.7 or newer. To works with python 3.6 must install the versión 0.5.1.

Before, you must be request free the omdbapi api key here

Install the library, Python 3.7 or newer:

>>> pip install omdbapi

To works with python 3.6 must install the versión 0.5.1

>>> pip install omdbapi==0.5.1

import the library and get movie, passing api key and title as parameter, default return short plot:

>>> from omdbapi.movie_search import GetMovie

>>> movie = GetMovie(api_key='your api key')

Get all data movie json format:

>>> movie.get_movie(title='Interstellar')

{'title': 'Interstellar',
 'year': '2014',
 'rated': 'PG-13',
 'released': '07 Nov 2014',
 'runtime': '169 min',
 'genre': 'Adventure, Drama, Sci-Fi',
 'director': 'Christopher Nolan',
 'writer': 'Jonathan Nolan, Christopher Nolan',
 'actors': 'Ellen Burstyn, Matthew McConaughey, Mackenzie Foy, John Lithgow',
 'plot': "A team of explorers travel through a wormhole in space in an attempt to ensure humanity's survival.",
 'language': 'English',
 'country': 'USA, UK, Canada',
 'awards': 'Won 1 Oscar. Another 43 wins & 148 nominations.',
 'poster': 'https://m.media-amazon.com/images/M/MV5BZjdkOTU3MDktN2IxOS00OGEyLWFmMjktY2FiMmZkNWIyODZiXkEyXkFqcGdeQXVyMTMxODk2OTU@._V1_SX300.jpg',
 'ratings': [{'Source': 'Internet Movie Database', 'Value': '8.6/10'},
  {'Source': 'Rotten Tomatoes', 'Value': '72%'},
  {'Source': 'Metacritic', 'Value': '74/100'}],
 'metascore': '74',
 'imdbrating': '8.6',
 'imdbvotes': '1,569,520',
 'imdbid': 'tt0816692',
 'type': 'movie',
 'dvd': '24 May 2016',
 'boxoffice': '$188,020,017',
 'production': 'Lynda Obst Productions, Syncopy',
 'website': 'N/A',
 'response': 'True'}

Or can set full plot as parameter:

>>> movie.get_movie(title='Interstellar', plot='full')
{'title': 'Interstellar',
 'year': '2014',
 'rated': 'PG-13',
 'released': '07 Nov 2014',
 'runtime': '169 min',
 'genre': 'Adventure, Drama, Sci-Fi',
 'director': 'Christopher Nolan',
 'writer': 'Jonathan Nolan, Christopher Nolan',
 'actors': 'Ellen Burstyn, Matthew McConaughey, Mackenzie Foy, John Lithgow',
 'plot': "Earth's future has been riddled by disasters, famines, and droughts. There is only one way to ensure mankind's survival: Interstellar travel. A newly discovered wormhole in the far reaches of our solar system allows a team of astronauts to go where no man has gone before, a planet that may have the right environment to sustain human life.",
 'language': 'English',
 'country': 'USA, UK, Canada',
 'awards': 'Won 1 Oscar. Another 43 wins & 148 nominations.',
 'poster': 'https://m.media-amazon.com/images/M/MV5BZjdkOTU3MDktN2IxOS00OGEyLWFmMjktY2FiMmZkNWIyODZiXkEyXkFqcGdeQXVyMTMxODk2OTU@._V1_SX300.jpg',
 'ratings': [{'Source': 'Internet Movie Database', 'Value': '8.6/10'},
  {'Source': 'Rotten Tomatoes', 'Value': '72%'},
  {'Source': 'Metacritic', 'Value': '74/100'}],
 'metascore': '74',
 'imdbrating': '8.6',
 'imdbvotes': '1,569,520',
 'imdbid': 'tt0816692',
 'type': 'movie',
 'dvd': '24 May 2016',
 'boxoffice': '$188,020,017',
 'production': 'Lynda Obst Productions, Syncopy',
 'website': 'N/A',
 'response': 'True'}

Get values using keys as parameter:

>>> movie.get_data('director', 'actors', 'awards', 'plot')

{'director': 'Christopher Nolan',
 'actors': 'Ellen Burstyn, Matthew McConaughey, Mackenzie Foy, John Lithgow',
 'awards': 'Won 1 Oscar. Another 43 wins & 148 nominations.',
 'plot': "A team of explorers travel through a wormhole in space in an attempt to ensure humanity's survival."}

Project details


Download files

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

Files for omdbapi, version 0.6.0
Filename, size File type Python version Upload date Hashes
Filename, size omdbapi-0.6.0.tar.gz (18.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page