Getting Access to the API

Fresh

Access to the IMDb GraphQL API requires an AWS account and an active subscription to one of the IMDb API products on AWS Data Exchange.

Prerequisites

Before subscribing, ensure you have:

• AWS Account — An active Amazon Web Services account. If you do not have one, create one at aws.amazon.com.
• AWS Access Keys — Programmatic access credentials consisting of:
  • Access Key ID (format: AKIA...)
  • Secret Access Key (a 40-character string)
  • These are generated in the AWS IAM console under your user or a dedicated service account
• AWS Cost Explorer (optional) — Recommended for monitoring API usage costs. Enable it in the AWS Billing console.

Available API Products

1. IMDb Essential Metadata for Movies/TV/OTT

This is the standard product for most use cases. It includes:

• Extended title metadata: plot, technical specs, AKAs, certificates, content ratings
• Ratings: aggregate rating, vote count
• Credits: full cast with character names, crew organized by category
• Keywords with vote counts
• Awards: nominations and wins, filterable by event
• Episodes: episode lists and season data for TV series
• Name data: filmography, known-for titles, trademarks, death information

2. IMDb and Box Office Mojo

A superset of the Essential Metadata product. Adds:

• Opening weekend gross by territory
• Lifetime gross revenue by territory with rankings
• Gross time series data (weekly, by territory)
• Production budgets

Choose this product if your application displays or analyzes box office performance data.

Subscription Steps

1. Log in to the AWS Management Console
2. Navigate to AWS Data Exchange (search "Data Exchange" in the service search bar)
3. In the left navigation, click Discover data products
4. Search for "IMDb" to find the available products
5. Select the product you need and click Continue to subscribe
6. Review the subscription terms and click Subscribe

Subscriptions are processed immediately. Once active, you can retrieve your access credentials from the product details page.

Locating Your API Credentials

After subscribing, you need four values to call the API:

Credential	Where to Find It	Used As
Endpoint URL	Product details page	Request URL
API Key (x-api-key)	Product details page	Request header
Data Set ID	Product details page	x-amzn-dataexchange-data-set-id header
Revision ID	Product details page	revision-id header
Asset ID	Product details page	asset-id header

Endpoint

api-fulfill.dataexchange.us-east-1.amazonaws.com/v1

All API requests are sent as HTTP POST to this endpoint with your query in the request body.

Finding Data Set ID, Revision ID, and Asset ID

1. In the AWS Data Exchange console, navigate to My subscriptions
2. Click on your IMDb subscription
3. Under Entitled data sets, click on the data set
4. The data-set-id is shown in the URL and on the data set page
5. Click into the data set to find Revisions
6. The most recent revision contains the revision-id and asset-id you need

Keep these values secure. Store them as environment variables rather than hardcoding them in source code.