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

# IMDb title detail

`GET /imdb/title`

## Request

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

Returns an IMDb title's details. Pass exactly one of `id` (such as `tt1375666`) or `url`. The response has the title, type, year, release date, runtime, genres, plot, content rating, rating and count, popularity rank, directors and up to three lead cast. Rating and cast fields appear only when present.

## Query parameters

- `id` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ImdbTitleResponseDoc
  - `code` integer
  - `data` ImdbTitleResponse
    - `cast` ImdbPerson[]: Up to three lead cast members.
      - `name` string: Name of the person.
      - `url` string: IMDb page URL of the person.
    - `content_rating` string: Age rating shown for the title, for example `PG-13`.
    - `directors` ImdbPerson[]: Directors of the title.
      - `name` string: Name of the person.
      - `url` string: IMDb page URL of the person.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `genres` string[]: Genres IMDb lists for the title.
    - `id` string: IMDb title ID, for example `tt1375666`.
    - `image_url` string: URL of the title's main image.
    - `plot` string: Plot summary of the title.
    - `popularity_rank` integer: Current IMDb popularity rank of the title.
    - `public_page_derived` boolean: Always `true`. The data comes from IMDb's public pages.
    - `rating_count` integer: Number of user ratings behind the rating value.
    - `rating_value` number: Average IMDb user rating of the title.
    - `release_date` string: Release date of the title, for example `2010-07-16`.
    - `runtime_minutes` integer: Running time of the title in minutes.
    - `source_url` string: URL the data was read from.
    - `title` string: Title name as shown on IMDb.
    - `title_type` string: Kind of title, for example `Movie`.
    - `url` string: IMDb page URL of the title.
    - `year` string: Release year 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/0497899e2016?raw)