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). |
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
Change Log
- 04/08/19
- Added support for eight digit IMDb IDs.
- 01/20/19
- Supressed adult content from search results.
- 01/20/19
- 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