IMDb+API.SH

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
One IMDb title
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}
1 credit · $1 per 1,000 calls

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 advanced title search/imdb/v1/advanced-search
sortpopularityorderasctotal117next_cursoreyJlc1Rva2VuIjpbIjQ1NDM0NSIsIjQ1…
constraints[]titleTextConstraint · titleTypeConstraint
titles[]id · url · title · original_title · type · type_text · year · end_year · release_date · rating · votes · runtime_minutes
IMDb people born on a day/imdb/v1/born-today
date11-03urlhttps://www.imdb.com/search/name…total1608count50next_cursoreyJlc1Rva2VuIjpbIjIzMzE4IiwiMjMz…
people[]id · url · name · born · died · image · professions · known_for · popularity_rank
IMDb weekend box office/imdb/v1/boxoffice
weekend_start2026-10-30weekend_end2026-11-01urlhttps://www.imdb.com/chart/boxof…count10
titles[]rank · weekend_gross · currency · domestic_total · worldwide_total · id · url · title · original_title · type · year · end_year

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

Search and discovery4
IMDb advanced title search
/imdb/v1/advanced-search
params none required +19 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb chart
/imdb/v1/chart
params none required +1 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title search
/imdb/v1/search
params q +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb search suggestions
/imdb/v1/suggest
params qdocstry
$1 · $2 PAYG
1 credit
Profiles and accounts7
IMDb people born on a day
/imdb/v1/born-today
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
One IMDb person
/imdb/v1/person
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb person awards and nominations
/imdb/v1/person/awards
params id +3 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb person biography
/imdb/v1/person/bio
params iddocstry
$1 · $2 PAYG
1 credit
IMDb person filmography
/imdb/v1/person/filmography
params id +4 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb person news
/imdb/v1/person/news
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title company credits
/imdb/v1/title/companies
params id +3 optionaldocstry
$1 · $2 PAYG
1 credit
Posts and media3
IMDb series episodes
/imdb/v1/episodes
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title photos
/imdb/v1/title/photos
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title trailers and videos
/imdb/v1/title/videos
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews1
IMDb title reviews
/imdb/v1/reviews
params url +3 optionaldocstry
$1 · $2 PAYG
1 credit
More data15
IMDb weekend box office
/imdb/v1/boxoffice
params none required +1 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb coming soon
/imdb/v1/coming-soon
params none required +5 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb public list
/imdb/v1/list
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb news feed
/imdb/v1/news
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
One IMDb title
/imdb/v1/title
params iddocstry
$1 · $2 PAYG
1 credit
IMDb title awards and nominations
/imdb/v1/title/awards
params id +3 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb full cast and crew
/imdb/v1/title/credits
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title goofs
/imdb/v1/title/goofs
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title news
/imdb/v1/title/news
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb parents guide
/imdb/v1/title/parentsguide
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb title quotes
/imdb/v1/title/quotes
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb release dates and alternate titles
/imdb/v1/title/releaseinfo
params iddocstry
$1 · $2 PAYG
1 credit
IMDb more like this
/imdb/v1/title/similar
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit
IMDb technical specs
/imdb/v1/title/technical
params iddocstry
$1 · $2 PAYG
1 credit
IMDb title trivia
/imdb/v1/title/trivia
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit

Call the IMDb API

One IMDb title: GET https://api.api.sh/imdb/v1/title

curl "https://api.api.sh/imdb/v1/title?id=tt0111161" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More media & music APIs all music, movie & game APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key