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
4
Documented params
98
Examples
21
Live catalog snapshot
Active endpoints
23
Methods
GET
Required params
24
Schema refs
23
{
"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 — 23 endpoints, 98 documented request parameters, and 23 published response schemas — the same catalog Docs and Playground run against.
23 documented IMDb endpoints, grouped into 4 request families — Title, Name and Search, plus 1 more.
98 request parameters are documented across those IMDb endpoints, 24 of them required — the full input contract is public before you write any integration code.
21 of the 23 IMDb endpoints ship a recorded example response, and 23 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.
23 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
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/imdb/title
/imdb/name
/imdb/search
/imdb/charts
Featured endpoints
/imdb/searchReturns normalized IMDb title search rows from credential-free public IMDb pages. Limit defaults to 10 and clamps to 20.
Response notes
- `data.results` contains normalized title rows with IMDb title IDs and public title URLs. - Empty parsed results are treated as parser drift unless IMDb returns an explicit no-results marker. - IMDb WAF or robot-verification pages return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "inception", "limit": 10, "results": [ { "id": "tt1375666", "title": "Inception", "url": "https://www.imdb.com/title/tt1375666/", "year": "2010" } ] } } ```
MCP tool imdb_search
/imdb/titleReturns normalized IMDb title metadata from a credential-free public IMDb title page. Pass exactly one of `id` or `url`.
Response notes
- `data.public_page_derived` is `true`. - Rating, popularity, cast, and director fields are included only when present on the public page. - IMDb WAF or robot-verification pages return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "title": "Inception", "year": "2010", "runtime_minutes": 148, "genres": ["Action", "Adventure", "Sci-Fi"], "rating_value": 8.8, "public_page_derived": true } } ```
MCP tool imdb_title
/imdb/title/creditsReturns normalized public IMDb full cast and crew sections. Pass exactly one of `id` or `url`.
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 normalized 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. IMDb serves cast in full but caps most crew sections, so a large crew section can return a subset. - 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "sections": [ { "name": "Cast", "slug": "cast", "credits": [ { "name": "Leonardo DiCaprio", "url": "https://www.imdb.com/name/nm0000138/", "character": "Dom Cobb" } ] } ], "public_page_derived": true } } ```
MCP tool imdb_title_credits
/imdb/title/reviewsReturns normalized 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 rather than a parser-drift error, because no credential-free extraction is possible when the data is simply absent. - 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "limit": 10, "reviews": [ { "id": "rw2500001", "title": "A smart blockbuster", "rating": 9, "helpful_votes": 123, "total_votes": 150, "spoiler": false } ], "public_page_derived": true } } ```
MCP tool imdb_title_reviews
/imdb/title/episodesReturns normalized public IMDb episode rows for a series title. Limit defaults to 10 and clamps to 20. Optional `season` filters the upstream episodes page. 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. - 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt0944947", "season": 1, "limit": 10, "episodes": [ { "id": "tt1480055", "title": "Winter Is Coming", "url": "https://www.imdb.com/title/tt1480055/", "season": 1, "episode": 1, "air_date": "17 Apr 2011", "rating_value": 8.9, "rating_count": 52000 } ], "public_page_derived": true } } ```
MCP tool imdb_title_episodes
/imdb/title/awardsReturns normalized public IMDb award rows for a title. Pass exactly one of `id` or `url`.
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. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "tt1375666", "awards": [ { "event": "Academy Awards, USA", "year": "2011", "category": "Best Achievement in Cinematography", "result": "win", "award": "Oscar", "recipients": [{"name": "Wally Pfister"}], "public_signals": 6 } ], "public_page_derived": true } } ```
MCP tool imdb_title_awards
Related APIs
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Media & Streaming
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
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.
FAQ
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.