IMDb API endpoint
Returns a person's IMDb filmography, grouped into sections such as Actor, Director and Self. Pass exactly one of `id` or `url`. Each credit has its title, year, role and episode count. A section returns up to 100 credits, so `total` can exceed the rows returned.
/imdb/name/creditsQuery parameters:
id: IMDb name ID, for example nm0634240.url: absolute IMDb name URL, for example
https://www.imdb.com/name/nm0634240/.Notable response behavior:
data.sections groups public filmography rows by category when IMDb exposes
a category heading.sections follows IMDb's own grouping (Actor, Producer, Director,
Self, ...).credits[].year is a range such as 2014-2019 for titles that ran across
several years.credits[].episodes is set for episodic credits, for example 8 episodes.sections[].total is the number of credits IMDb lists for that grouping, and
sections[].has_more is true when the response returns fewer. Each
grouping returns up to 100 credits, so a prolific person's Self section
can return fewer rows than total.| Field | Filled in, of 9 checked | Values in the sample |
|---|---|---|
| name | 9 | “Actor” and 8 other values |
| slug | 9 | |
| credits | 9 | median 14 entries |
| total | 9 | 1 to 431, median 14 |
| has_more | 2 | true in 2 of 2 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | IMDb name id | nm0634240 | |
| url | string | No | Absolute https://www.imdb.com/name/<id>/ URL | https://www.imdb.com/name/nm0634240/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/imdb/name/credits" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "nm0634240",
"sections": [
{
"name": "Director",
"slug": "director",
"credits": [
{
"id": "tt1375666",
"title": "Inception",
"url": "https://www.imdb.com/title/tt1375666/",
"year": "2010",
"role": "directed by"
}
]
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.nameCreditsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.NameCreditsResponse | No | ||||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.id | string | No | nm0634240 | IMDb name ID of the person, for example `nm0634240`. | ||
| data.public_page_derived | boolean | No | true | Always `true`. The data comes from IMDb's public pages. | ||
| data.sections | array | No | Credits of the person, grouped by job. | |||
| data.sections[].credits | array | No | Credits the person has in this section. | |||
| data.sections[].credits[].episodes | string | No | 3 episodes | Number of episodes the person is credited on, as IMDb words it, for example `3 episodes`. | ||
| data.sections[].credits[].id | string | No | tt1375666 | IMDb title ID of the credited title. | ||
| data.sections[].credits[].role | string | No | directed by | Role or character credited for the person on the title, for example `Self`. | ||
| data.sections[].credits[].title | string | No | Inception | Name of the credited title. | ||
| data.sections[].credits[].url | string | No | https://www.imdb.com/title/tt1375666/ | IMDb page URL of the credited title. | ||
| data.sections[].credits[].year | string | No | 2010 | Release year of the credited title. | ||
| data.sections[].has_more | boolean | No | true | `true` when IMDb lists more credits in this section than were returned. | ||
| data.sections[].name | string | No | Director | Section heading, usually the job, for example `Director`. | ||
| data.sections[].slug | string | No | director | Lowercase, hyphenated form of the section name, for example `director`. | ||
| data.sections[].total | integer | No | 152 | Number of credits IMDb lists in this section. | ||
| data.source_url | string | No | https://www.imdb.com/name/nm0634240/ | URL the data was read from. | ||
| data.url | string | No | https://www.imdb.com/name/nm0634240/ | IMDb page URL of the person. | ||
| 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/name/credits" \
-H "x-api-key: $CRAWLORA_API_KEY"