Developer
Contact us
  • Documentation
  • Key Concepts
  • Overview
  • Getting Access to the API
  • API Key Concepts
  • Calling the API
  • Sample Queries
  • Title/Name
  • Box Office
  • Search
  • Overview
  • Bulk Data Key Concepts
  • Data Dictionary
  • Names
  • Titles
  • Box Office
  • Querying In Athena
  • Creating Tables DDL
  • Release Notes

Getting Access to the API

Prerequisites

To access the IMDb API, you will need the following:

  • An AWS Account - The IMDb API is exclusively available through AWS Data Exchange and requires an AWS account to access GraphQL-backed API products. To create an AWS Account, follow the AWS instructions listed here.
  • AWS Access Keys - The AWS Access Keys are long-term credentials to authenticate you, so you can perform actions in an AWS account programmatically. Access Keys come in two parts: an Access Key ID and a Secret Access Key. To find out how to create an AWS Access Key, take a look at this documentation on AWS Access Keys.
  • (Optional) Enabling AWS Cost Explorer - Enabling AWS Cost Explorer is necessary to see your cost and usage of the IMDb API. To enable Cost Explorer please follow the AWS instructions listed here. You can also find more information on how to see your cost and usage here.

API Products

IMDb Ratings for Movies/TV/OTT (API)

IMDb's world-renowned 1-10 star rating, a daily-computed average of votes from IMDb's more than 200 million monthly visitors.

  • Basic title data
  • IMDb Ratings

IMDb Essential Metadata for Movies/TV/OTT (API)

IMDb's essential metadata for every movie, TV and OTT series, and video game title as well as performers and creators.

  • Extended title data
  • IMDb Ratings
  • Name Data

IMDb and Box Office Mojo for Movies/TV/OTT (API)

Essential metadata package plus daily, weekend weekly, and lifetime box office grosses from Box Office Mojo.

  • Extended title data
  • IMDb Ratings
  • Name Data
  • Box Office Performance Data

Subscribe to the IMDb API

Once you have satisfied the prerequisites, you can request an IMDb API trial. To do this:

  1. Click the link of the API Product you would like to try out.
  2. Click “Continue to subscribe”.
  3. Sign into your AWS Account if prompted.
  4. Review the product offer and subscription terms for accuracy and complete the subscription request by clicking “Send subscription request to provider”. Subscription requests will be processed by IMDb staff within five business days. Once approved, a notification email will be sent and the status updated under “Subscriptions requests”. Subscription details are located under “Subscriptions”.

Locate IDs and API Key

To access the API you will need the Endpoint, API Key, data-set-id, revision-id, and asset-id of your subscription. These are unique for each subscriptions.

Locating the IDs

  1. Under the “Entitled Data” page, select the product you wish to access, go to the most recent revision, and then click the API asset under the revision.
  2. Under the “Asset Overview” section, locate the details of the Endpoint, data-set-id, revision-id, and asset-id for the product. Make a note of these.

Locating your API Key

  1. You can find your API key in an email from a member of IMDb staff.
  2. Make a note of this API key.

Call the API

Now that you’re subscribed to a product on AWS Data Exchange, access to an endpoint will be granted (api-fulfill.dataexchange.us-east-1.amazonaws.com/v1) and you can begin querying IMDb data sets. Check out the Calling The API page to make some calls.

API Key Concepts

Learn about the key concepts of the API before diving into how to make your own GraphQL queries

Get started

Contact us to see how IMDb’s data can empower your customers.

Contact us
  • Conditions of Use
  • Privacy Policy

© 1990-2023 by IMDb.com, Inc.