---
title: "IMDb title release info"
method: GET
path: "/imdb/title/release-info"
tags: ["IMDb"]
---

# IMDb title release info

`GET /imdb/title/release-info`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/imdb/title/release-info`
- Auth: API key in header `x-api-key`

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`.

## Query parameters

- `id` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ImdbReleaseInfoResponseDoc
  - `code` integer
  - `data` ImdbReleaseInfoResponse
    - `alternate_titles` ImdbAlternateTitle[]: Alternate titles (also known as) IMDb lists for the title.
      - `country` string: Country or region the alternate title is used in.
      - `title` string: Alternate title as listed for that country.
      - `type` string: Kind of alternate title, when IMDb gives one.
    - `alternate_titles_total` integer: Number of alternate titles IMDb lists for the title.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `has_more` boolean: `true` when IMDb lists more release dates than were returned.
    - `id` string: IMDb title ID, for example `tt1375666`.
    - `public_page_derived` boolean: Always `true`. The data comes from IMDb's public pages.
    - `releases` ImdbReleaseInfoItem[]: Release dates of the title by country.
      - `country` string: Country or region of the release.
      - `date` string: Release date as IMDb shows it, for example `16 July 2010`.
      - `note` string: Note on the release, for example `theatrical`.
    - `source_url` string: URL the data was read from.
    - `total` integer: Number of release dates IMDb lists for the title.
    - `url` string: IMDb release info page of the title.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)