IMDb API endpoint
Returns the release dates and alternate titles IMDb lists for a title. Pass exactly one of `id` or `url`. Releases have a country, date and note; alternate titles have a country, title and type. Both lists are often shorter than `total` and `alternate_titles_total`.
/imdb/title/release-infoReturns public IMDb release date rows and alternate titles.
Query 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.releases contains country, date, and optional release notes.data.alternate_titles contains country, title, and optional title type when
IMDb exposes AKA rows.data.total is the number of releases IMDb lists and
data.alternate_titles_total the number of alternate titles;
data.has_more is true when the response returns fewer releases than
data.total. IMDb server-renders only the first few of each, so both lists
are commonly much shorter than their totals.| Field | Filled in, of 82 checked | Values in the sample |
|---|---|---|
| country | 82 | “United Arab Emirates” and 65 other values |
| title | 82 | “The Shawshank Redemption” and 58 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/release-info" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tt1375666",
"releases": [
{
"country": "United States",
"date": "16 July 2010",
"note": "theatrical"
}
],
"alternate_titles": [
{
"country": "United States",
"title": "Inception",
"type": "original title"
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/imdb.releaseInfoResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | imdb.ReleaseInfoResponse | No | ||||
| data.alternate_titles | array | No | Alternate titles (also known as) IMDb lists for the title. | |||
| data.alternate_titles[].country | string | No | United States | Country or region the alternate title is used in. | ||
| data.alternate_titles[].title | string | No | Inception | Alternate title as listed for that country. | ||
| data.alternate_titles[].type | string | No | original title | Kind of alternate title, when IMDb gives one. | ||
| data.alternate_titles_total | integer | No | 82 | Number of alternate titles IMDb lists for the title. | ||
| 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 release dates than were returned. | ||
| data.id | string | No | tt1375666 | IMDb title ID, for example `tt1375666`. | ||
| data.public_page_derived | boolean | No | true | Always `true`. The data comes from IMDb's public pages. | ||
| data.releases | array | No | Release dates of the title by country. | |||
| data.releases[].country | string | No | United States | Country or region of the release. | ||
| data.releases[].date | string | No | 16 July 2010 | Release date as IMDb shows it, for example `16 July 2010`. | ||
| data.releases[].note | string | No | theatrical | Note on the release, for example `theatrical`. | ||
| data.source_url | string | No | https://www.imdb.com/title/tt1375666/releaseinfo/ | URL the data was read from. | ||
| data.total | integer | No | 71 | Number of release dates IMDb lists for the title. | ||
| data.url | string | No | https://www.imdb.com/title/tt1375666/releaseinfo/ | IMDb release info page of the title. | ||
| 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/release-info" \
-H "x-api-key: $CRAWLORA_API_KEY"