OMDb API
  • Usage
  • Parameters
  • Examples
  • Change Log
  • API Key
  • Become a Patron
  • Donate
  • Contact

OMDb API

The Open Movie Database

The OMDb API is a RESTful web service to obtain movie information, all content and images on the site are contributed and maintained by our users.

If you find this service useful, please consider making a one-time donation or become a patron.

Poster API

The Poster API is only available to patrons.

Currently over 280,000 posters, updated daily with resolutions up to 2000x3000.

My Tesla Referral Link

Sponsors

Emby, Trakt, FileBot, Reelgood, Xirvik Servers, Yidio, mi.tv, Couchpop, Edu Reviewer, Flixboss, Scripts on Screen, Topagency.webflow.io, Ramotion.com, Phone Trackers, Classics on DVD, Streaming App, How to make a FinTech app, Vid2 - Create movie lists with AI, Popflick, Custom Couch, TV.GURU, Deploy Vision - Nearshore Software Development, Phictly

Usage

Send all data requests to:

http://www.omdbapi.com/?apikey=[yourkey]&

Poster API requests:

http://img.omdbapi.com/?apikey=[yourkey]&

Parameters

By ID or Title

Parameter Required Valid Options Default Value Description
i Optional* <empty> A valid IMDb ID (e.g. tt1285016)
t Optional* <empty> Movie title to search for.
type No movie, series, episode <empty> Type of result to return.
y No <empty> Year of release.
plot No short, full short Return short or full plot.
r No json, xml json The data type to return.
callback No <empty> JSONP callback name.
v No 1 API version (reserved for future use).
*Please note while both "i" and "t" are optional at least one argument is required.

By Search

Parameter Required Valid options Default Value Description
s Yes <empty> Movie title to search for.
type No movie, series, episode <empty> Type of result to return.
y No <empty> Year of release.
r No json, xml json The data type to return.
page New! No 1-100 1 Page number to return.
callback No <empty> JSONP callback name.
v No 1 API version (reserved for future use).

Examples

By Title
           

Request:

Response:


                        
By ID
        

Request:

Response:


                        

Change Log

  • 04/08/19
    • Added support for eight digit IMDb IDs.
  • 01/20/19
    • Supressed adult content from search results.
  • 01/20/19
    • Added Swagger files (YAML, JSON) to expose current API abilities and upcoming REST functions.
  • 11/02/17
    • FREE KEYS! The "open" API is finally open again!
  • 08/20/17
    • I created a GitHub repository for tracking bugs.
  • 05/10/17
    • Due to some security concerns on how the keys were being distributed I updated the form to email them and also changed the algorithm used, which means your older keys not obtained through email will eventually stop working.
  • 01/12/17
    • Removed single character restriction from title/search results.
  • 06/11/16
    • "totalSeasons" count has been added to series results.
  • 1/20/16
    • To accommodate search paging "totalResults" is now returned at the root level.
  • 12/12/15
    • Search pagination added: http://www.omdbapi.com/?s=Batman&page=2
  • 11/16/15
    • Season+Episode now works with "i" parameter: http://www.omdbapi.com/?i=tt0944947&Season=1
    • Fixed the max pool size connection issues.
  • 10/18/15
    • You can now return all episodes by using just the "Season" parameter: http://www.omdbapi.com/?t=Game of Thrones&Season=1
  • 9/9/15
    • New server is up, response times should be < 500ms.
    • Setup a CDN/Caching service with CloudFlare
  • 8/15/15
    • Created and Fixed a bad parsing error with JSON response. -Sorry about that!
    • HTTPS (with TLS) is now active: https://www.omdbapi.com/
  • 5/10/15
    • Season+Episode search parameters added: http://www.omdbapi.com/?t=Game of Thrones&Season=1&Episode=1
  • Back to top
  • Legal
  • Donate

API by Brian Fritz.

All content licensed under CC BY-NC 4.0.

This site is not endorsed by or affiliated with IMDb.com.