IMDb API endpoint
Returns 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.
/imdb/title/creditsQuery 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.sections contains named public credit sections such as cast,
directed by, and writing credits when present on IMDb.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./. Writing credits are the exception: they are listed one row
per credit, as IMDb lists them.| Field | Filled in, of 38 checked | Values in the sample |
|---|---|---|
| name | 38 | “Director” and 37 other values |
| slug | 38 | |
| credits | 38 | median 3 entries |
| total | 38 | 1 to 156, median 3 |
| has_more | 1 | true in 1 of 1 |
| 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/credits" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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
}
}Request schema
No body schema
Response schema
#/definitions/imdb.creditsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.CreditsResponse | No | ||||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | |||
| data.id | string | No | tt1375666 | |||
| data.public_page_derived | boolean | No | true | |||
| data.sections | array | No | ||||
| data.sections[].credits | array | No | ||||
| data.sections[].credits[].character | string | No | Dom Cobb | |||
| data.sections[].credits[].name | string | No | Christopher Nolan | |||
| data.sections[].credits[].role | string | No | written by | |||
| data.sections[].credits[].url | string | No | https://www.imdb.com/name/nm0634240/ | |||
| data.sections[].has_more | boolean | No | true | |||
| data.sections[].name | string | No | Directed by | |||
| data.sections[].slug | string | No | directed-by | |||
| data.sections[].total | integer | No | 145 | |||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/fullcredits/ | |||
| data.url | string | No | https://www.imdb.com/title/tt1375666/fullcredits/ | |||
| 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/credits" \
-H "x-api-key: $CRAWLORA_API_KEY"