IMDb API endpoint
Returns 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.
/imdb/titleReturns IMDb title metadata.
Query parameters:
id: IMDb title ID, for example tt1375666.url: absolute IMDb title URL, for example
https://www.imdb.com/title/tt1375666/.Notable response behavior:
data.public_page_derived is true.cast lists up to three lead cast members.| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| name | 3 | “Tim Robbins” and 2 other values |
| url | 3 | imdb.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | IMDb title id | tt1375666 | |
| url | string | No | Absolute https://www.imdb.com/title/<id>/ URL | https://www.imdb.com/title/tt1375666/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/title" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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
}
}Request schema
No body schema
Response schema
#/definitions/imdb.titleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.TitleResponse | No | ||||
| data.cast | array | No | Up to three lead cast members. | |||
| data.cast[].name | string | No | Christopher Nolan | Name of the person. | ||
| data.cast[].url | string | No | https://www.imdb.com/name/nm0634240/ | IMDb page URL of the person. | ||
| data.content_rating | string | No | PG-13 | Age rating shown for the title, for example `PG-13`. | ||
| data.directors | array | No | Directors of the title. | |||
| data.directors[].name | string | No | Christopher Nolan | Name of the person. | ||
| data.directors[].url | string | No | https://www.imdb.com/name/nm0634240/ | IMDb page URL of the person. | ||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.genres | array | No | Action | Genres IMDb lists for the title. | ||
| data.id | string | No | tt1375666 | IMDb title ID, for example `tt1375666`. | ||
| data.image_url | string | No | URL of the title's main image. | |||
| data.plot | string | No | Plot summary of the title. | |||
| data.popularity_rank | integer | No | 82 | Current IMDb popularity rank of the title. | ||
| data.public_page_derived | boolean | No | true | Always `true`. The data comes from IMDb's public pages. | ||
| data.rating_count | integer | No | 2600000 | Number of user ratings behind the rating value. | ||
| data.rating_value | number | No | 8.8 | Average IMDb user rating of the title. | ||
| data.release_date | string | No | 2010-07-16 | Release date of the title, for example `2010-07-16`. | ||
| data.runtime_minutes | integer | No | 148 | Running time of the title in minutes. | ||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/ | URL the data was read from. | ||
| data.title | string | No | Inception | Title name as shown on IMDb. | ||
| data.title_type | string | No | Movie | Kind of title, for example `Movie`. | ||
| data.url | string | No | https://www.imdb.com/title/tt1375666/ | IMDb page URL of the title. | ||
| data.year | string | No | 2010 | Release year of the title. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/imdb/title" \
-H "x-api-key: $CRAWLORA_API_KEY"