The IMDB API is a lightweight web service which provides efficient access to most of IMDB’s data. IMDB’s dataset is available for download, but there is no good API for retrieving information. This web service aims to bridge that gap by providing data in a range of formats.
Currently we support the following data formats when returning IMDB information:
You can keep up to date with what's happening by following me on Twitter!
Running a web service that handles a large volume of traffic is not cheap. Any donations to help with the cost of running the web service is most appreciated. Click the button below to donate
Send all requests to:
http://www.deanclatworthy.com/imdb/
Parameters:
| Parameter | Required | Valid options | Default Value | Description |
|---|---|---|---|---|
| q | Yes | <empty> | The name of the movie you wish to search for (e.g. Finding Nemo, The Green Mile) | |
| type | No | json, jsonp, xml, text | json | The data type you wish the API to return. Note: when using "text" as the type, do not rely on the order of the information |
| year | No | 2012 | The year you wish to search for. If you omit the year it will automatically use the current year when searching. | |
| yg | No | 1,0 | 0 | Either pass in a value 1 or 0. This parameter disables year guessing. If you omit the year parameter, set this option to 0 to disable it assuming the movie came out in the current year. |
| token | No | 10 | When returning data in the "text" format. You can specify the decimal ascii code of the character you wish to split the data tokens by. |
Request:
http://www.deanclatworthy.com/imdb/?q=The+Green+Mile
Response:
{"imdbid":"tt0120689","imdburl":"http:\/\/www.imdb.com\/title\/tt0120689\/","genres":"Crime,Drama,Fantasy,Mystery","languages":"English ,French","country":"USA","votes":"281023","stv":0,"series":0,"rating":"8.4","title":"The Green Mile","year":"1999","usascreens":2875,"ukscreens":340}
Request:
http://www.deanclatworthy.com/imdb/?q=The+Grey
Response:
{"imdbid":"tt1601913","imdburl":"http:\/\/www.imdb.com\/title\/tt1601913\/","genres":"Action,Adventure,Drama,Thriller","languages":"English","country":"USA","votes":"815","stv":0,"series":0,"rating":"7.5","title":"The Grey","year":"2012","usascreens":0,"ukscreens":0}
Request:
http://www.deanclatworthy.com/imdb/?q=Star+Trek&year=1996
Response:
{"imdbid":"tt0117731","imdburl":"http:\/\/www.imdb.com\/title\/tt0117731\/","genres":"Action,Adventure,Sci-Fi,Thriller","languages":"English","country":"USA","votes":"54968","stv":0,"series":0,"rating":"7.5","title":"Star Trek: First Contact","year":"1996","usascreens":2812,"ukscreens":0}
Request:
http://www.deanclatworthy.com/imdb/?q=Finding+Nemo&yg=0
Response:
{"imdbid":"tt0266543","imdburl":"http:\/\/www.imdb.com\/title\/tt0266543\/","genres":"Animation,Adventure,Comedy,Family","languages":"English","country":"Australia,USA","votes":"243868","stv":0,"series":0,"rating":"8.1","title":"Finding Nemo","year":"2003","usascreens":3425,"ukscreens":501}