www.omdbapi.com Open in urlscan Pro
104.22.0.141  Public Scan

Form analysis
2 forms found in the DOM

<form class="well form-search" id="search-by-title-form" onsubmit="return false;">
  <fieldset>
    <legend>By Title</legend>
  </fieldset>
  <div>
    <label class="control-label" for="t">Title:</label>
    <input type="text" id="t" name="t" class="input-small"> &nbsp;&nbsp; <label class="control-label" for="y">Year:</label>
    <input type="text" id="y" name="y" class="input-small" style="width: 100px;"> &nbsp;&nbsp; <label class="control-label">Plot:</label>
    <select name="plot" style="width: 100px;">
      <option value="" selected="">Short</option>
      <option value="full">Full</option>
    </select> &nbsp;&nbsp; <label class="control-label">Response:</label>
    <select name="r" style="width: 100px;">
      <option value="">JSON</option>
      <option value="xml">XML</option>
    </select> &nbsp;&nbsp; <button id="search-by-title-button" type="button" class="btn-sm btn-primary">Search</button>
    <button id="search-by-title-reset" type="reset" class="btn-sm">Reset</button>
  </div>
  <div class="hide" id="search-by-title-request">
    <br>
    <p>Request:</p>
    <pre class="alert alert-box"><a href="javascript:;" target="_blank"></a></pre>
  </div>
  <div id="search-by-title-progress" class="hide progress progress-info progress-striped active">
    <div class="progress-bar" style="width: 100%;">
    </div>
  </div>
  <div class="hide" id="search-by-title-response">
    <p>Response:</p>
    <pre class="alert alert-success" style="margin-bottom: 0px; white-space: normal;"></pre>
  </div>
</form>

<form class="well form-search" id="search-by-id-form" onsubmit="return false;">
  <fieldset>
    <legend>By ID</legend>
  </fieldset>
  <div>
    <label class="control-label" for="i">ID:</label>
    <input type="text" id="i" name="i" class="input-small" placeholder="IMDb ID"> &nbsp;&nbsp; <label class="control-label">Plot:</label>
    <select name="plot" style="width: 100px;">
      <option value="" selected="">Short</option>
      <option value="full">Full</option>
    </select> &nbsp;&nbsp; <label class="control-label">Response:</label>
    <select name="r" style="width: 100px;">
      <option value="">JSON</option>
      <option value="xml">XML</option>
    </select> &nbsp;&nbsp; <button id="search-by-id-button" type="button" class="btn-sm btn-primary">Search</button>
    <button id="search-by-id-reset" type="reset" class="btn-sm">Reset</button>
  </div>
  <div class="hide" id="search-by-id-request">
    <br>
    <p>Request:</p>
    <pre class="alert alert-box"><a href="javascript:;" target="_blank"></a></pre>
  </div>
  <div id="search-by-id-progress" class="hide progress progress-info progress-striped active">
    <div class="progress-bar" style="width: 100%;">
    </div>
  </div>
  <div class="hide" id="search-by-id-response">
    <p>Response:</p>
    <pre class="alert alert-success" style="margin-bottom: 0px; white-space: normal;"></pre>
  </div>
</form>

Text Content

OMDb API
 * Usage
 * Parameters
 * Examples
 * Change Log
 * API Key

 * Become a Patron
 * Donate
 * Contact


OMDB API

The Open Movie Database

The OMDb API is a RESTful web service to obtain movie information, all content
and images on the site are contributed and maintained by our users.

If you find this service useful, please consider making a one-time donation or
become a patron.

POSTER API

The Poster API is only available to patrons.

Currently over 280,000 posters, updated daily with resolutions up to 2000x3000.

×

ATTENTION USERS

04/08/19 - Added support for eight digit IMDb IDs.

01/20/19 - Supressed adult content from search results.

01/20/19 - Added Swagger files (YAML, JSON) to expose current API abilities and
upcoming REST functions.

  Become a Patron


SPONSORS

Emby, Trakt, FileBot, Reelgood, Xirvik Servers, Yidio, mi.tv, Couchpop, Edu
Reviewer, Flixboss, Scripts on Screen, Medium.com, Ramotion.com, Phone Trackers,
Classics on DVD, Streaming App, How to make a FinTech app, Vid2 - Create movie
lists with AI, Popflick


USAGE

Send all data requests to:

http://www.omdbapi.com/?apikey=[yourkey]&


Poster API requests:

http://img.omdbapi.com/?apikey=[yourkey]&


PARAMETERS

BY ID OR TITLE

Parameter Required Valid Options Default Value Description i Optional* <empty> A
valid IMDb ID (e.g. tt1285016) t Optional* <empty> Movie title to search for.
type No movie, series, episode <empty> Type of result to return. y No <empty>
Year of release. plot No short, full short Return short or full plot. r No json,
xml json The data type to return. callback No <empty> JSONP callback name. v No
1 API version (reserved for future use).

*Please note while both "i" and "t" are optional at least one argument is
required.

--------------------------------------------------------------------------------

BY SEARCH

Parameter Required Valid options Default Value Description s Yes <empty> Movie
title to search for. type No movie, series, episode <empty> Type of result to
return. y No <empty> Year of release. r No json, xml json The data type to
return. page New! No 1-100 1 Page number to return. callback No <empty> JSONP
callback name. v No 1 API version (reserved for future use).


EXAMPLES

By Title
Title:    Year:    Plot: Short Full    Response: JSON XML    Search Reset



Request:





Response:



By ID
ID:    Plot: Short Full    Response: JSON XML    Search Reset



Request:





Response:




CHANGE LOG

 * 11/02/17
   * FREE KEYS! The "open" API is finally open again!
 * 08/20/17
   * I created a GitHub repository for tracking bugs.
 * 05/10/17
   * Due to some security concerns on how the keys were being distributed I
     updated the form to email them and also changed the algorithm used, which
     means your older keys not obtained through email will eventually stop
     working.
 * 01/12/17
   * Removed single character restriction from title/search results.
 * 06/11/16
   * "totalSeasons" count has been added to series results.
 * 1/20/16
   * To accommodate search paging "totalResults" is now returned at the root
     level.
 * 12/12/15
   * Search pagination added: http://www.omdbapi.com/?s=Batman&page=2
 * 11/16/15
   * Season+Episode now works with "i" parameter:
     http://www.omdbapi.com/?i=tt0944947&Season=1
   * Fixed the max pool size connection issues.
 * 10/18/15
   * You can now return all episodes by using just the "Season" parameter:
     http://www.omdbapi.com/?t=Game of Thrones&Season=1
 * 9/9/15
   * New server is up, response times should be < 500ms.
   * Setup a CDN/Caching service with CloudFlare
 * 8/15/15
   * Created and Fixed a bad parsing error with JSON response. -Sorry about
     that!
   * HTTPS (with TLS) is now active: https://www.omdbapi.com/
 * 5/10/15
   * Season+Episode search parameters added: http://www.omdbapi.com/?t=Game of
     Thrones&Season=1&Episode=1
 * 5/2/15
   * Poster API: Enabled client side caching.
   * Database normalization.
 * 3/27/15
   * Corrected JSON/JSONP response types per RFC standards.
   * Changed Caching-control to Public.
 * 3/15/15
   * Episodes will now return Season/Episode/SeriesID.
 * 3/8/15
   * New caching system in place, response times should be much better.
   * Set a max limit of 20 concurrent connections, if you get 403 errors you may
     need to delay your responses a bit.
 * 2/15/15
   * Poster API: Now returns 404 error if poster not found.
 * 1/1/15
   * You can now search by type! (movie, series, episode etc.)
   * Dupes have been removed from database.
   * Poster API images updated.
 * 11/1/14
   * New site layout!
   * Poster API still undergoing stress tests by donors.
   * Fixed some issues causing invalid JSON/XML due to non escaped quotes.

 * Back to top
 * Legal
 * Donate

API by Brian Fritz.

All content licensed under CC BY-NC 4.0.

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