IMDB API

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.

This site is not endorsed by or affiliated with IMDb.com

Stay in touch

You can keep up to date with what's happening, new features, and future breaking changes by following me on Twitter!

Extra requests?

If you want to make more requests in an hour, you'll have to pay to keep the server online. Donate some BTC and then email me to tell me.

  • 30 req/hr - Free
  • 60 req/hr - 0.01BTC/month
  • 120 req/hr - 0.02BTC/month
  • More? - Get in touch

Donate bitcoin


API usage

Send all requests to:

http://deanclatworthy.com/imdb/

Search: By Title

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 2014 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. Note: [a-z0-9_] are valid characters. Anything else will be stripped

Search: By ID

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)

Examples

  1. Finding a film with just the movie title

    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}
    
  2. Finding a film with the movie title and year guessing (defaults to current year)

    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}
    
  3. Finding a film with the movie title and specifying a year

    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}
    
  4. Finding a film with the movie title and turning off year guessing

    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}
    
  5. Finding a film by its IMDB ID

    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}
    

Notes & Tips

Change log