IMDb API endpoint
Returns the awards IMDb lists for a person. Pass exactly one of `id` or `url`. Each row has the event, year, category, `win` or `nomination` result, award name, recipients and related titles. `total` is the count IMDb lists, and `has_more` is true when fewer rows are returned.
/imdb/name/awardsQuery 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.awards contains public award rows with event, year, category, result,
award name, recipients, related titles, notes, and signal counts when present.result is normalized to win or nomination when IMDb exposes a
clear winner/nominee marker.awards[].result is win or nomination.awards[].titles names the works the award relates to.data.total is the number of awards IMDb lists, and data.has_more is true
when the response returns fewer than that.| Field | Filled in, of 154 checked | Values in the sample |
|---|---|---|
| event | 154 | “Washington DC Area Film Critics Association Awards” and 75 other values |
| year | 154 | 1,987 to 2,025, median 2,005 |
| category | 131 | “Best Actor” and 62 other values |
| result | 154 | nomination (89), win (65) |
| award | 154 | “WAFCA Award” and 77 other values |
| recipients | 154 | median 1 entry |
| titles | 120 | median 1 entry |
| public_signals | 154 | 5 to 8, median 7 |
| notes | 17 | “The nomination for Heath Ledger was posthumous.” and 15 other values |
| 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/awards" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "nm0634240",
"awards": [
{
"event": "Academy Awards, USA",
"year": "2024",
"category": "Best Achievement in Directing",
"result": "win",
"award": "Oscar",
"titles": [
{
"id": "tt15398776",
"title": "Oppenheimer"
}
],
"public_signals": 6
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.nameAwardsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.NameAwardsResponse | No | ||||
| data.awards | array | No | Award entries IMDb lists for the person. | |||
| data.awards[].award | string | No | Oscar | Name of the award given, for example `Oscar`. | ||
| data.awards[].category | string | No | Best Motion Picture of the Year | Award category, for example `Best Motion Picture of the Year`. | ||
| data.awards[].event | string | No | Academy Awards, USA | Name of the awards event, for example `Academy Awards, USA`. | ||
| data.awards[].notes | string | No | Extra note IMDb attaches to the award entry. | |||
| data.awards[].public_signals | integer | No | 6 | Number of details filled in on this entry, counted across event, year, category, result, award, recipients, titles and notes. | ||
| data.awards[].recipients | array | No | People who received the award. | |||
| data.awards[].recipients[].name | string | No | Christopher Nolan | Name of the person. | ||
| data.awards[].recipients[].url | string | No | https://www.imdb.com/name/nm0634240/ | IMDb page URL of the person. | ||
| data.awards[].result | string | No | nomination | Outcome of the entry, for example `nomination`. | ||
| data.awards[].titles | array | No | Titles the award entry refers to. | |||
| data.awards[].titles[].id | string | No | tt1375666 | IMDb title ID, for example `tt1375666`. | ||
| data.awards[].titles[].title | string | No | Inception | Name of the title the award entry refers to. | ||
| data.awards[].titles[].url | string | No | https://www.imdb.com/title/tt1375666/ | IMDb page URL of the title. | ||
| data.awards[].year | string | No | 2011 | Year of the award entry, for example `2011`. | ||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.has_more | boolean | No | true | `true` when IMDb lists more award entries than were returned. | ||
| 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.source_url | string | No | https://www.imdb.com/name/nm0634240/awards/ | URL the data was read from. | ||
| data.total | integer | No | 64 | Number of award entries IMDb lists for the person. | ||
| data.url | string | No | https://www.imdb.com/name/nm0634240/awards/ | IMDb awards page 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/awards" \
-H "x-api-key: $CRAWLORA_API_KEY"