+IMDb API
IMDb titles, ratings, cast and crew, episodes, reviews, awards, box office and people as JSON, without an AWS Data Exchange contract.
The API.SH IMDb API returns public IMDb pages as JSON. A title gives rating and vote count with the rating histogram, Metascore, genres, plot, runtime, cast, directors, writers, release date, countries, languages, box office and popularity rank, and dedicated endpoints add the full cast and crew, episodes by season, user reviews, awards, release dates and alternate titles, company credits, parents guide, technical specs, trivia, goofs, quotes, photos, trailers, news and similar titles. People come with biography, full filmography by role, awards and news. For discovery there are title search, search suggestions, the advanced search with every filter of IMDb's form (genre, year, rating, votes, runtime, language, country, certificate), IMDb charts, the US weekend box office, coming soon, born today, public lists and news feeds.
- 30 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/imdb/v1/ title
{"id": "tt0111161","url": "https://www.imdb.com/title/tt0111161/","name": "The Shawshank Redemption","original_name": "The Shawshank Redemption","type": "Movie","rating_value": 9.3,"rating_count": 3261294,"metascore": 82,"content_rating": "R","genre": ["Drama"],"description": "After a banker is sentenced to life in Shawshank Prison, he forms an unlikely friendship with a seasoned inmate and clings to hope amid crue…","cast": [{"id": "nm0000209","name": "Tim Robbins","url": "https://www.imdb.com/name/nm0000209/"},{"id": "nm0000151","name": "Morgan Freeman","url": "https://www.imdb.com/name/nm0000151/"},"… 2 more"],"directors": [{"id": "nm0001104","name": "Frank Darabont","url": "https://www.imdb.com/name/nm0001104/"}],"writers": [{"id": "nm0000175","name": "Stephen King","url": "https://www.imdb.com/name/nm0000175/"},{"id": "nm0001104","name": "Frank Darabont","url": "https://www.imdb.com/name/nm0001104/"}],"runtime_minutes": 142,"keywords": ["prison","based on the works of stephen king","… 18 more"],"box_office": {"budget": {"amount": 25000000,"currency": "USD"},"gross_us_canada": {"amount": 28767189,"currency": "USD"},"gross_worldwide": {"amount": 29425588,"currency": "USD"},"opening_weekend": {"amount": 727327,"currency": "USD"}},"release_date": "1994-10-14","year": 1994,"end_year": null,"countries": ["United States"],"languages": ["English"],"episodes": null,"seasons": null,"image": "https://m.media-amazon.com/images/M/MV5BMDAyY2FhYjctNDc5OS00MDNlLThiMGUtY2UxYWVkNGY2ZjljXkEyXkFqcGc@._V1_.jpg","title_type_id": "movie","is_series": false,"is_episode": false,"is_adult": false,"top_rank": 1,"popularity_rank": 71,"popularity_change": {"direction": "DOWN","difference": 22},"rating_histogram": [{"rating": 1,"votes": 43690},{"rating": 2,"votes": 5698},"… 8 more"],"content_rating_reason": "Rated R for language and prison violence","content_rating_body": "MPAA","metacritic_reviews": 22,"metacritic_url": "https://www.metacritic.com/movie/the-shawshank-redemption?ftag=MCD-06-10aaa1c","user_reviews": 12079,"critic_reviews": 152,"runtime_text": "2h 22m","…": "39 more fields","cached": false,"credits_used": 1} What you can build with the IMDb API
Movie and TV apps
Fill title pages with rating, Metascore, plot, cast, runtime, certificate, poster and trailers, and add episodes with ratings for every season of a series, keyed on the IMDb id (tt...).
Recommendations and catalog search
Filter IMDb's whole catalog with advanced search by genre, release years, minimum rating and votes, runtime and language, then add the titles IMDb lists as more like this for each pick.
Film industry analysis
Track the US weekend box office with domestic and worldwide totals, read company credits for production and distribution, and follow release dates by country to study release strategies.
Audience review analysis
Page through a title's user reviews and compare them with its rating histogram and Metascore to see how audiences and critics split, or run sentiment over reviews of a whole franchise.
Talent research
Read a person's biography, full filmography filtered by role (director, writer, actor, producer) and every award win or nomination, for casting databases, agency rosters or film trivia sites.
Family viewing and content advisories
Show the parents guide severity votes for sex and nudity, violence, profanity, drugs and frightening scenes, alongside the certificate, so parents can decide before watching.
IMDb data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
IMDb API endpoints and prices
Every IMDb endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| IMDb advanced title search /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb chart /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title search /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb search suggestions /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb people born on a day /imdb/ | $1 · $2 PAYG 1 credit |
| One IMDb person /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb person awards and nominations /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb person biography /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb person filmography /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb person news /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title company credits /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb series episodes /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title photos /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title trailers and videos /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title reviews /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb weekend box office /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb coming soon /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb public list /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb news feed /imdb/ | $1 · $2 PAYG 1 credit |
| One IMDb title /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title awards and nominations /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb full cast and crew /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title goofs /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title news /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb parents guide /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title quotes /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb release dates and alternate titles /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb more like this /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb technical specs /imdb/ | $1 · $2 PAYG 1 credit |
| IMDb title trivia /imdb/ | $1 · $2 PAYG 1 credit |
Call the IMDb API
One IMDb title: GET https://api.api.sh/imdb/
curl "https://api.api.sh/imdb/v1/title?id=tt0111161" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/imdb/v1/title",
params={"id": "tt0111161"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/imdb/v1/title");
url.searchParams.set("id", "tt0111161");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/imdb/v1/title", "id", "tt0111161")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "IMDb" and "One IMDb title".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for IMDb data
- Public data only: no IMDb login, cookies or account needed
- One key and one response shape for IMDb and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official IMDb API
IMDb's official API is a paid GraphQL product sold through AWS Data Exchange, which needs an AWS account and a subscription; IMDb's free datasets are for personal and non-commercial use and cover only basic fields. API.SH returns public IMDb pages as JSON per call with one key.
OMDb and TMDB are separate databases with their own coverage and terms, and Cinemagoer or GitHub IMDb scrapers break when IMDb redesigns its pages. API.SH reads IMDb itself and keeps the endpoints maintained, with TMDB, Letterboxd and Rotten Tomatoes under the same key.
IMDb API questions
What IMDb data can I get?+
Titles: details, full cast and crew, episodes, reviews, awards, release dates and AKAs, company credits, parents guide, technical specs, trivia, goofs, quotes, photos, videos, news and similar titles. People: profile, biography, filmography, awards and news. Discovery: search, suggestions, advanced search, charts, box office, coming soon, born today, lists and news feeds.
How much does the IMDb API cost?+
Every IMDb endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Does IMDb have a free API?+
No. IMDb's API is a paid AWS Data Exchange subscription. API.SH gives every account 1,000 free credits a month, with no AWS account or card. That is 1,000 calls to /imdb/v1/advanced-search at 1 credit each.
Are IMDb and TMDB the same?+
No. TMDB is a separate, community-built movie database with its own free API; IMDb is Amazon's. API.SH has both: this page reads IMDb, and the TMDB API page reads TMDB.
How do I get IMDb ratings through an API?+
Call /imdb/v1/title?id=tt0111161: the response has rating_value, rating_count, the rating histogram, Metascore and IMDb's popularity rank. Episodes carry their own ratings in /imdb/v1/episodes.
How do I find a title's IMDb id?+
Use /imdb/v1/search?q=inception or /imdb/v1/suggest for a few typed letters; each result has its tt id. People ids start with nm.
Does IMDb allow web scraping?+
IMDb's terms limit automated collection and commercial reuse of its data. API.SH returns only public pages; check IMDb's conditions of use and license data properly if you publish or resell it.
Can I use the IMDb API from Python?+
Yes. Send GET https://api.api.sh/imdb/v1/title/credits?id=tt0468569 with your key in the x-api-key header, or use the Python SDK, in place of a Cinemagoer setup.
How do I get started?+
Sign up at api.sh, copy your key and call /imdb/v1/chart?type=top. Every IMDb route is documented at https://api.sh/docs with a live example. Movie bots and agents can use the MCP server at https://api.sh/mcp; the SDKs, Google Sheets, Zapier, Make and n8n work the same way.
Does the IMDb API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many IMDb calls in parallel as you need and pay only for the calls that run. If IMDb itself slows down, the call returns 503 with a retry-after header and is not charged.