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.
The Poster API is only available to patrons.
Currently over 280,000 posters, updated daily with resolutions up to 2000x3000.
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
Send all data requests to:
http://www.omdbapi.com/?apikey=[yourkey]&
Poster API requests:
http://img.omdbapi.com/?apikey=[yourkey]&
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). |
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). |