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.

Attention Users

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.

  Become a Patron

Sponsors

Emby, Trakt, FileBot, Reelgood, Xirvik Servers, Yidio, mi.tv, Couchpop, What's on Netflix, Edu Reviewer, Flixboss, StreamingMoviesRight, Streamcentrum.se, Scripts on Screen, Writers Per Hour, Classic Movies, Medium.com, Write my paper, Best Movie Apps For Android, Ramotion.com, Phone Trackers, Property for sale in Lake Como, Download.it - Streaming Guide, Trading Indicator, iStarTips, What A Room

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

  • 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
  • 5/2/15
    • Poster API: Enabled client side caching.
    • Database normalization.
  • 3/27/15
    • Corrected JSON/JSONP response types per RFC standards.
    • Changed Caching-control to Public.
  • 3/15/15
    • Episodes will now return Season/Episode/SeriesID.
  • 3/8/15
    • New caching system in place, response times should be much better.
    • Set a max limit of 20 concurrent connections, if you get 403 errors you may need to delay your responses a bit.
  • 2/15/15
    • Poster API: Now returns 404 error if poster not found.
  • 1/1/15
    • You can now search by type! (movie, series, episode etc.)
    • Dupes have been removed from database.
    • Poster API images updated.
  • 11/1/14
    • New site layout!
    • Poster API still undergoing stress tests by donors.
    • Fixed some issues causing invalid JSON/XML due to non escaped quotes.
  • 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.