Title and cast metadata enrichment
Use IMDb endpoints to turn title and cast metadata enrichment into repeatable API requests with documented inputs and JSON responses.
Collect IMDb title and name detail, cast and crew credits, awards, episodes and seasons, user reviews, parental guide, keywords, trivia, goofs, quotes, and technical specs as normalized JSON for catalogs, enrichment, and agent-native workflows.
Extract IMDb titles, names, credits, awards, episodes, reviews, ratings, keywords, trivia, and specs as structured JSON from public pages.
Endpoint families
5
Documented params
124
Examples
30
Live catalog snapshot
Active endpoints
30
Methods
GET
Required params
31
Schema refs
30
{
"platform": "IMDb",
"endpoint": "imdb-search",
"method": "GET",
"path": "/imdb/search",
"auth": "apiKey"
}Related use cases
Use cases
Extract IMDb titles, names, credits, awards, episodes, reviews, ratings, keywords, trivia, and specs as structured JSON from public pages.
Use IMDb endpoints to turn title and cast metadata enrichment into repeatable API requests with documented inputs and JSON responses.
Use IMDb endpoints to turn reviews and ratings collection into repeatable API requests with documented inputs and JSON responses.
Use IMDb endpoints to turn episode and awards tracking into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live IMDb endpoint catalog — 30 endpoints, 124 documented request parameters, and 30 published response schemas — the same catalog Docs and Playground run against.
30 documented IMDb endpoints, grouped into 5 request families — Title, Name and Search, plus 2 more.
124 request parameters are documented across those IMDb endpoints, 31 of them required — the full input contract is public before you write any integration code.
30 of the 30 IMDb endpoints ship a recorded example response, and 30 carry a documented response schema — you can code against the real JSON before the first request.
IMDb endpoints document their error responses (400, 401, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
30 hosted MCP tools back the IMDb endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/imdb/title
/imdb/name
/imdb/search
/imdb/charts
/imdb/image-types
Featured endpoints
/imdb/searchSearches IMDb titles by `query`, returning up to `limit` rows (default 10, max 20). Each result has the title id, title, URL, year, title type, image and a description holding the lead cast. A query with no matches returns an empty `results` list.
Response notes
- `data.results` contains title rows with IMDb title IDs and public title URLs, plus `year`, `title_type`, `image_url` and `description` (the lead cast) when IMDb has them. - A query with no matches returns an empty `results` list. - IMDb WAF or robot-verification pages return an upstream error.
MCP tool imdb_search
/imdb/titleReturns an IMDb title's details. Pass exactly one of `id` (such as `tt1375666`) or `url`. The response has the title, type, year, release date, runtime, genres, plot, content rating, rating and count, popularity rank, directors and up to three lead cast. Rating and cast fields appear only when present.
Response notes
- `data.public_page_derived` is `true`. - Rating, popularity, cast, and director fields are included only when present on the public page. `cast` lists up to three lead cast members. - IMDb WAF or robot-verification pages return an upstream error.
MCP tool imdb_title
/imdb/title/creditsReturns the full cast and crew IMDb lists for a title, in named sections. Pass exactly one of `id` or `url`. Each credit has a name, IMDb name URL, role and, for cast, the character. The cast returns up to 2,000 rows and other sections up to 100.
Response notes
- `data.sections` contains named public credit sections such as cast, directed by, and writing credits when present on IMDb. - Each credit row includes a person name, optional IMDb name URL, role, and character. `role` carries the crew job; `character` is set on cast rows only. - `sections[].total` is the number of credits IMDb lists for that section, and `sections[].has_more` is `true` when the section returns fewer than that. The cast is returned in full (up to 2,000 rows); every other section returns up to 100 credits. - A person with several jobs in one section is a single row with the jobs joined by ` / `. Writing credits are the exception: they are listed one row per credit, as IMDb lists them. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success.
MCP tool imdb_title_credits
/imdb/title/reviewsReturns public IMDb user review rows. Limit defaults to 10 and clamps to 20. Pass exactly one of `id` or `url`.
Response notes
- `data.reviews` contains public review title, author, date, rating, text, spoiler marker, and helpful-vote counts when present. - `data.total` is the number of reviews IMDb lists for the title, and `data.has_more` is `true` when the response returns fewer than that. IMDb serves only the most recent reviews on the page, so `data.reviews` is commonly much shorter than `data.total` regardless of `limit`. - Empty parsed review rows are treated as parser drift. - IMDb sometimes serves a sign-in card in place of the review list, with no review data in the response at all. That case returns a distinct upstream error naming the sign-in wall. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success.
MCP tool imdb_title_reviews
/imdb/title/episodesReturns public IMDb episode rows for a series title. Limit defaults to 10 and clamps to 20. Optional `season` filters the episodes returned. Pass exactly one of `id` or `url`.
Response notes
- `data.episodes` contains public episode IDs, titles, season/episode numbers, air dates, ratings, vote counts, and plot snippets when IMDb exposes them. - `data.total` is the number of episodes IMDb lists for the requested season, and `data.has_more` is `true` when the response returns fewer than that. - Without `season`, the first season is returned. - Unaired or unrated episodes omit `air_date`, `rating_value`, and `rating_count`. - Empty episode pages are treated as upstream parser drift unless IMDb states an explicit zero count for the season. - IMDb WAF or robot-verification pages return an upstream error. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success.
MCP tool imdb_title_episodes
/imdb/title/awardsReturns the awards IMDb lists for a title. Pass exactly one of `id` or `url`. Each row has the event, year, category, `win` or `nomination` result, award name, recipients and notes. `total` is the number IMDb lists and `has_more` is true when only part is returned.
Response notes
- `data.awards` contains public award rows with event, year, category, result, award name, recipients, related titles, notes, and signal counts when present. - Award `result` is normalized to `win` or `nomination` when IMDb exposes a clear winner/nominee marker. - `awards[].result` is `win` or `nomination`. - `data.total` is the number of awards IMDb lists, and `data.has_more` is `true` when the response returns fewer than that: IMDb server-renders at most a few rows per awards event. - If IMDb changes its page payload, the endpoint returns an upstream parser-drift error rather than an empty or partial success. - IMDb WAF or robot-verification pages return an upstream error.
MCP tool imdb_title_awards
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Company coverage
Amazon.com, Inc. · AMZN
IMDb is operated by Amazon.com, Inc. (AMZN). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the IMDb endpoints above.
SEC filings & financials API →How to scrape IMDb
IMDb's title and people data power film and TV research. Crawlora's IMDb endpoints return title, name, search, and review data as structured JSON.
A movie or show by IMDb ID, a person, or a keyword search.
Pass the IMDb ID (tt… / nm…) or query to Crawlora's IMDb endpoint.
Receive title, year, rating, genres, runtime, cast, plot, and reviews as clean JSON.
Batch many titles to build catalogs for recommendation, research, or enrichment.
客户端库
为你的语言安装 IMDb 专用客户端。每个包都覆盖本页的 IMDb 端点，并使用你的 API 密钥调用 Crawlora 托管 API。
npm install @crawlora-org/imdbnpmpip install crawlora-imdbPyPIgo get github.com/Crawlora-org/crawlora-imdbpkg.go.devgem install crawlora-imdbRubyGemsnet.crawlora:crawlora-imdbMaven Centralcomposer require crawlora/imdbPackagistcargo add crawlora-imdbcrates.ioFAQ
Send an IMDb title ID, person ID, or search query to Crawlora's IMDb endpoint and get structured JSON — title, year, rating, genres, cast, plot, reviews — without writing parsers. Collect public data and respect IMDb's terms.
Yes — Crawlora returns publicly visible ratings, genres, cast, and user reviews for a title. It collects only public data, not logged-in account information.
Collecting publicly accessible title and review data is generally permissible if you respect IMDb's terms of use, robots directives, rate limits, and applicable law. This is for public data you're authorized to collect.
Not a general-purpose one. IMDb publishes free non-commercial datasets — bulk TSV exports with no ratings breakdown, reviews, or images — and a separate commercial API sold only through AWS Data Exchange with its own subscription and usage billing. Crawlora's IMDb endpoints return title, name, credit, review, and search data as normalized JSON with a single API key, no AWS account or dataset parsing required.