Movie API

This app is a proof of concept and is not intended for use. Consult IMDB's terms before screen scraping them.

This app screen scrapes IMDB for basic information. All responses are available in JSON and XML formats, except the top 250 which is only availble in JSON.

A demo of this app is running at movieapi.herokuapp.com. The root path goes nowhere, so use one of the endpoints described below.

Endpoints

Movie Details

Returns the movie with the provided IMDB ID (ex: tt1049413)

Path: /movies/:imdb_id.:format
Example: /movies/tt1049413.json

Movie Search

Returns the first 10 results that match your search query

Path: /movies/:term.:format
Example: /movies/up.json

Top 250

Returns the IMDB top 250 (only available in JSON format)

Path: /movies/top250.:format
Example: /movies/top250.json

Response data

Attribute	Description	Example
id	IMDB ID	tt1049413
title	Movie title	Up
release_year	Film release year	2009
rating	IMDB aggregate rating	8.4
storyline	The storyline of the movie	A movie about a boy and an old man going on a journey

Cast Member Data

Movie data also includes a collection of cast member information. Here is an example:

  <cast-members type="array">
    <cast-member>
      <character>
        <name>Carl Fredricksen</name>
        <page>http://www.imdb.com/character/ch0091853/</page>
      </character>
      <person>
        <name>Edward Asner</name>
        <page>http://www.imdb.com/name/nm0000799/</page>
      </person>
    </cast-member>
    <cast-member>
      <character>
        <name>Charles Muntz</name>
        <page>http://www.imdb.com/character/ch0143952/</page>
      </character>
      <person>
        <name>Christopher Plummer</name>
        <page>http://www.imdb.com/name/nm0001626/</page>
      </person>
    </cast-member>
  </cast-members>

JohnColvin/movieapi