IMDB API

IMDB API

This is a lightweight web service(REST interface) which provides a easy way to access the IMDB data.

This site is not endorsed by or affiliated with IMDb.com. All data use for non-commercial purposes (personal use only).

Support data formats

  • JSON
  • JSONP
  • XML

Stay in touch

  • Follow @imdbapi
  • Mail to [email protected]

Donate

Contents

  1. Version
  2. API Endpoint
  3. Search: By title
  4. Search: By ID(s)
  5. Examples
  6. Fields
  7. Notes
  8. Change log

Version

IMDB API: 1.2.3

Database: 2013-05-02

Request: http://imdbapi.org/api/version?type=xml

API usage

Send all requests to:

http://imdbapi.org/

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 json The data type you wish the API to return.
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 When this parameter is 0, the year parameter is disabled.
mt No none, M, TV, TVS, V, VG none The movie type you wish to search for.
plot No none, simple, full simple The plot type you wish the API to return.
episode No 1,0 1 When the parameter is 0, "episodes" is not included in the result.
offset No 0 The API to return to starting from that offset, specify the offset will enable paging, please try it.
limit No 1 - 10 1 The number of records you wish to API to return.
lang No en-US, zh-CN en-US The data language you wish the API to reutrn.
aka No simple,full simple The aka type you wish the API to return.
release No simple,full simple The release date type you wish the API to return.
business No 1, 0 0 Whether to include the business field in the result.
tech No 1, 0 0 Whether to include the technical field in the result.

Search: By ID(s)

Parameters:

Parameter Required Valid options Default Value Description
id (or ids) Yes /^tt\d+$/ The IMDB ID of the movie you wish to get the info for (e.g. tt0120689)
id  - only one IMDb ID.
ids - max 10 IMDb ID (comma-separated).
type No json, jsonp, xml json The data type you wish the API to return.
plot No none, simple, full simple The plot type you wish the API to return.
episode No 1,0 1 When the parameter is 0, "episodes" is not included in the result.
lang No en-US, zh-CN en-US The data language you wish the API to reutrn.
aka No simple,full simple The aka type you wish the API to return.
release No simple,full simple The release date type you wish the API to return.
business No 1, 0 0 Whether to include the business field in the result.
tech No 1, 0 0 Whether to include the technical field in the result.

Examples

Fields

Most of the fields are self-explanatory, so here only necessary instructions.

Field Type Description
actors List The movie's cast list.
also_known_as List The movie's other name. Fields(full mode): title country remarks
country List The movie's country.
directors List The movie's directors.
episodes List The TV series's episodes(only TV series). Fields: date season episode title.
film_locations List The movie's locations.
genres List The movie's genres.(e.g. Drama, War)
imdb_id String The movie's ID on IMDb.com.
imdb_url String The movie's url on IMDb.com.
language List The movie's audio language.
plot String The movie's summary.
plot_simple String The movie's summary.(short)
poster String The movie's poster.
rated String The movie's classification and ratings.
rating Float The score of the movie on IMDb.com.
rating_count Int The number of voters on IMDb.com.
release_date Int (simple mode),
List (full mode)		 The movie's release date. Fields(full mode): year month day country remarks
runtime List The movie's duration.
title String The movie's name.
type String The movie's type. Below are all the type:

M   - Movie
TVS - TV Series
TV  - TV Movie
V   - Video
VG  - Video Game
writers List The movie's writers.
year Int The movie's age.
business JSON The movie's business info. (Budget, Gross, Opening Weekend, Weekend Gross, Admissions, Filming Dates, Producation Dates, Copyright holder etc.)
technical JSON The movie's technical info. (Camera, Laboratory, Film Length, Film negative format, Cinematographic process, Printed film format, Aspect ratio etc.)

Notes & Tips

Change log