IMDb API endpoint
Returns an IMDb person's profile. Pass exactly one of `id` (such as `nm0634240`) or `url`. The response has the name, biography, birth and death dates, birth place, professions, image and a known-for list of titles with year and credit category.
/imdb/nameReturns IMDb person metadata and known-for rows.
Query 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.name, data.bio, data.birth_date, data.birth_place,
data.professions, and data.known_for are derived from public IMDb page
metadata when present.data.bio is the full biography text. data.birth_date and
data.death_date are YYYY-MM-DD, or shorter (YYYY-MM, YYYY) when IMDb
only records part of the date.data.known_for contains the titles IMDb lists the person as known for,
with IMDb title IDs, release year and the credit category.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| title | 10 | “Seven” and 9 other values |
| url | 10 | imdb.com |
| year | 10 | 1,989 to 2,014, median 2,003 |
| category | 10 | Actor in all 10 |
| 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" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "nm0634240",
"name": "Christopher Nolan",
"birth_date": "1970-07-30",
"birth_place": "London, England, UK",
"professions": [
"Director",
"Writer",
"Producer"
],
"known_for": [
{
"id": "tt1375666",
"title": "Inception",
"url": "https://www.imdb.com/title/tt1375666/"
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.nameResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.NameResponse | No | ||||
| data.bio | string | No | Full biography text of the person. | |||
| data.birth_date | string | No | 1970-07-30 | Date of birth as `YYYY-MM-DD`, or `YYYY-MM` or `YYYY` when IMDb records only part of it. | ||
| data.birth_place | string | No | London, England, UK | Place of birth, for example `London, England, UK`. | ||
| data.death_date | string | No | Date of death as `YYYY-MM-DD`, or `YYYY-MM` or `YYYY` when IMDb records only part of it. | |||
| 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.image_url | string | No | URL of the person's main photo. | |||
| data.known_for | array | No | Titles IMDb lists the person as known for. | |||
| data.known_for[].category | string | No | Director | Credit category of the person on this title, for example `Director`. | ||
| data.known_for[].id | string | No | tt1375666 | IMDb title ID of the title. | ||
| data.known_for[].title | string | No | Inception | Name of the title. | ||
| data.known_for[].url | string | No | https://www.imdb.com/title/tt1375666/ | IMDb page URL of the title. | ||
| data.known_for[].year | string | No | 2010 | Release year of the title. | ||
| data.name | string | No | Christopher Nolan | Name of the person as shown on IMDb. | ||
| data.professions | array | No | Professions IMDb lists for the person. | |||
| data.public_page_derived | boolean | No | true | Always `true`. The data comes from IMDb's public pages. | ||
| 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" \
-H "x-api-key: $CRAWLORA_API_KEY"