IMDb APIimdb.com ↗
Access IMDb movie details, full cast lists, popular movie charts, and filming locations via a structured API. Ratings, box office, genres, and more.
What is the IMDb API?
This API exposes 5 endpoints covering IMDb movie and TV title data, including ratings, cast, crew, financials, and filming locations. Use get_movie_details to retrieve a title's plot, IMDb rating with vote count, budget, box office, runtime, and up to 50 cast members with character names in a single call. Separate endpoints handle full paginated cast lists, the IMDb Movie Meter popularity chart, and both lookup and search of filming locations.
curl -X GET 'https://api.parse.bot/scraper/fe7b024f-ea0d-489a-b060-6f5bda26ccb7/get_movie_details?title_id=tt0816692&cast_limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Get comprehensive movie details including title, plot overview, IMDb rating, genres, cast (with character names), directors, writers, budget, box office, keywords, and more. The cast returned is capped by cast_limit; use get_full_cast for the complete list with pagination.
| Param | Type | Description |
|---|---|---|
| title_idrequired | string | IMDb title ID (e.g., tt0816692). The 'tt' prefix is optional. |
| cast_limit | integer | Maximum number of cast members to return (max 50). |
{
"type": "object",
"fields": {
"cast": "array of {name, id, characters}",
"plot": "string, plot summary",
"type": "string, content type (e.g. Movie, TV Series)",
"year": "integer, release year",
"image": "string, URL of primary image",
"title": "string, movie title",
"budget": "object with amount (integer) and currency (string), or null",
"genres": "array of genre strings",
"rating": "object with value (float) and vote_count (integer)",
"runtime": "string, human-readable runtime",
"writers": "array of {name, id, category}",
"end_year": "integer or null, end year for series",
"keywords": "array of keyword strings",
"taglines": "array of tagline strings",
"title_id": "string, IMDb title ID",
"countries": "array of country name strings",
"directors": "array of {name, id}",
"languages": "array of language name strings",
"total_cast": "integer, total number of cast members",
"release_date": "string, formatted release date (YYYY-MM-DD)",
"content_rating": "string, content rating (e.g. PG-13)",
"original_title": "string, original language title",
"runtime_seconds": "integer, runtime in seconds",
"worldwide_gross": "object with amount (integer) and currency (string), or null"
}
}About the IMDb API
Movie Details and Financial Data
The get_movie_details endpoint accepts an IMDb title ID (the tt prefix is optional) and returns a broad set of fields: title, year, type (e.g. Movie, TV Series), plot, genres, runtime, image, a rating object with value and vote_count, and a budget object with amount and currency (or null when unavailable). The cast array includes each member's name, IMDb person ID, and character names, capped at whatever cast_limit you supply (maximum 50).
Full Cast Pagination
When you need every cast member beyond that cap, get_full_cast provides cursor-based pagination. Each page returns up to 50 cast entries, a total count of all cast members listed on IMDb, and an end_cursor to pass as the after parameter on the next call. The has_next_page boolean tells you when to stop.
Popularity Chart and Filming Locations
get_popular_movies mirrors IMDb's Movie Meter chart, returning up to 100 titles ranked by current popularity. Each entry includes rank, title_id, year, image, rating, genres, languages, content_rating, plot, and runtime. The endpoint supports cursor-based pagination using the same after / end_cursor pattern.
For location data, get_filming_locations returns every IMDb-listed filming location for a given title — up to 2,000 records — with structured fields: location, locality, state_region, country, and location_note. search_filming_locations lets you find titles filmed in a specific place using a free-text location query; results are one record per matching location entry, ordered by IMDb popularity, and paginated with after / end_cursor.
The IMDb API is a managed, monitored endpoint for imdb.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when imdb.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official imdb.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a movie database app that displays IMDb ratings, genres, budget, and box office alongside plot summaries.
- Populate cast pages with complete actor lists and character names using get_full_cast pagination.
- Track weekly shifts in movie popularity by polling the get_popular_movies Movie Meter chart.
- Find all titles filmed in a specific city or region using search_filming_locations with a location term.
- Map production tourism data by extracting structured locality, state, and country fields from get_filming_locations.
- Enrich a content recommendation engine with IMDb vote counts, content ratings, and runtime data.
- Aggregate language and genre distribution across the top 100 popular movies for market research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does IMDb have an official developer API?+
What does get_filming_locations return, and how does it handle titles with many locations?+
Does the API return TV episode-level details, such as individual episode ratings or air dates?+
Does search_filming_locations return one result per title or one per location entry?+
total field in the response counts distinct titles, not individual location records. The after cursor paginates by title, up to 50 per page.