Send all data requests to:

http://www.omdbapi.com/?

Poster API requests:

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

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.
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.
tomatoes No true, false false Include Rotten Tomatoes ratings.
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.
y No <empty> Year of release.
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).