IMDb API endpoint
Returns the awards IMDb lists for a title. Pass exactly one of `id` or `url`. Each row has the event, year, category, `win` or `nomination` result, award name, recipients and notes. `total` is the number IMDb lists and `has_more` is true when only part is returned.
/imdb/title/awardsQuery 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.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.data.total is the number of awards IMDb lists, and data.has_more is true
when the response returns fewer than that: IMDb server-renders at most a few
rows per awards event.| Field | Filled in, of 64 checked | Values in the sample |
|---|---|---|
| event | 64 | “Academy Awards, USA” and 29 other values |
| year | 64 | 1,994 to 2,016, median 1,995 |
| category | 60 | “Best Picture” and 37 other values |
| result | 64 | nomination (43), win (21) |
| award | 64 | “Oscar” and 31 other values |
| recipients | 52 | median 1 entry |
| titles | 64 | median 1 entry |
| public_signals | 64 | 6 to 8, median 7 |
| notes | 7 | “Tied with Wallace Shawn for Vanya on 42nd Street (1994).” and 6 other values |
| 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/awards" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tt1375666",
"awards": [
{
"event": "Academy Awards, USA",
"year": "2011",
"category": "Best Achievement in Cinematography",
"result": "win",
"award": "Oscar",
"recipients": [
{
"name": "Wally Pfister"
}
],
"public_signals": 6
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.titleAwardsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.TitleAwardsResponse | No | ||||
| data.awards | array | No | AwardItem record, 14 fields: award, category, event, notes, public_signals, recipients, result, titles, year. Described under IMDb name awards API. | |||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | |||
| data.has_more | boolean | No | true | |||
| data.id | string | No | tt1375666 | |||
| data.public_page_derived | boolean | No | true | |||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/awards/ | |||
| data.total | integer | No | 64 | |||
| data.url | string | No | https://www.imdb.com/title/tt1375666/awards/ | |||
| 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/awards" \
-H "x-api-key: $CRAWLORA_API_KEY"