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, new features, and future breaking changes by following me on Twitter!
Running this service is not cheap, I only ask that people try to help cover the cost of the hosting.
Donation Target (2013)
Send all requests to:
http://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 | 2013 | 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. | |
| callback | No | imdbapi | When using the 'jsonp' type use this to over-ride the default callback function< |
Parameters:
| Parameter | Required | Valid options | Default Value | Description |
|---|---|---|---|---|
| id | Yes | /^tt\d+$/ |
The IMDB ID of the movie you wish to get the info for (e.g. tt0120689) |
Request:
http://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://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://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://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}
Request:
http://deanclatworthy.com/imdb/?id=tt0120689
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}