IMDb GraphQL API Overview

Fresh

The IMDb GraphQL API provides real-time access to the full IMDb database through a single GraphQL endpoint hosted on AWS Data Exchange. It is the primary way to query live IMDb data programmatically.

What the API Offers

• Single endpoint — all queries go through one URL, simplifying integration
• Selective field fetching — request only the fields your application needs, reducing payload size
• Multi-entity queries — query multiple titles or names simultaneously in a single request
• Real-time data — no 24-hour delay; data reflects the current state of the IMDb database
• Built-in search — find titles and names by text query or advanced filters
• AWS-native — leverages AWS authentication, authorization, and monitoring services

Available Data

Through the GraphQL API you can retrieve:

Category	Examples
Title metadata	Original title, AKAs, title type, year, runtime, color
Ratings	Aggregate rating, vote count
Credits	Cast with character names, crew by category, billing order
Plot	Short, medium, and long plot descriptions
Genres	Genre classifications
Technical specs	Runtime, color, aspect ratio
Keywords	User-contributed keywords with vote counts
Awards	Nominations, wins, filtered by event or category
Episodes	Episode lists for series, season/episode numbers
Box office	Opening gross, lifetime gross, production budget (requires separate product)
Search	Full-text search and advanced filtered search

API Products on AWS Data Exchange

Two separate product subscriptions are available depending on your needs:

IMDb Essential Metadata for Movies/TV/OTT

The core product. Provides access to:

• Extended title metadata (plot, technical specs, AKAs, certificates)
• Ratings and vote counts
• Full credits (cast and crew)
• Keywords, awards, episodes
• Name data (filmography, known-for)

IMDb and Box Office Mojo

Extends Essential Metadata with:

• Box office opening weekend grosses by territory
• Lifetime gross revenue by territory
• Ranked gross figures
• Production budgets

Both products are available through AWS Data Exchange and require an active subscription to access the API endpoint.

Architecture

The IMDb GraphQL API runs on AWS infrastructure and uses standard AWS authentication. Every request must be:

1. Authenticated using AWS Signature Version 4
2. Authorized by your active AWS Data Exchange subscription
3. Addressed to the correct endpoint with the required headers identifying your subscription assets

Requests that fail authentication or authorization return standard HTTP 403 responses. Requests to the wrong endpoint or with missing headers return 400 or 404 responses.

Getting Started

See the Getting Access page to set up your AWS account and subscription, then see Calling the API for code examples in TypeScript, Python, Java, and using Postman.