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

# IMDb advanced title search

`GET /imdb/search/title`

## Request

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

Returns IMDb advanced title-search results (imdb.com/search/title/). At least one filter is required; sort/limit alone are not enough. Limit defaults to 25 and clamps to 50; only IMDb's first page of results is returned (see `total`/`has_more`), there is no deeper cursor pagination. Genre/company/certificate/country/language/keyword/characters/role are include-only lists; there is no exclude support. Unsupported: genre exclude, three curated `groups` values (best-picture-nominee, best-director-nominee, national-film-registry), and the non-plot "page topic" search fields.

## Query parameters

- `title` string
- `title_type` string
- `genres` string
- `release_date_from` string
- `release_date_to` string
- `min_user_rating` number
- `max_user_rating` number
- `min_votes` integer
- `max_votes` integer
- `min_popularity` integer
- `max_popularity` integer
- `min_runtime` integer
- `max_runtime` integer
- `groups` string
- `keywords` string
- `companies` string
- `certificates` string
- `colors` string
- `countries` string
- `languages` string
- `sound_mixes` string
- `role` string
- `characters` string
- `plot` string
- `include_adult` boolean
- `sort` string
- `sort_order` string
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ImdbSearchTitleResponseDoc
  - `code` integer
  - `data` ImdbSearchTitleResponse
    - `fetched_at` string
    - `has_more` boolean
    - `limit` integer
    - `results` ImdbSearchTitleItem[]
      - `certificate` string
      - `genres` string[]
      - `id` string
      - `image_url` string
      - `metascore` integer
      - `plot` string
      - `rating_count` integer
      - `rating_value` number
      - `release_date` string
      - `runtime_minutes` integer
      - `title` string
      - `title_type` string
      - `url` string
      - `year` integer
    - `source_url` string
    - `total` integer
  - `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)