Endpoint Playground

Try the IMDb advanced title search API

Test Crawlora's IMDb advanced title search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /imdb/search/title
Platform: IMDb
Auth: apiKey
Credits: 3 credits/request
Required params: None
Common optional params: title, title_type, genres, release_date_from, release_date_to, min_user_rating

IMDb advanced title search API documentation IMDb platform page Crawlora API pricing Try IMDb name detail API Try IMDb name awards API Try IMDb name credits API Try IMDb title search API Try IMDb title detail API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/imdb/search/title" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
title	string	No	Title-name substring match
title_type	string	No	Comma-separated title types: `feature`, `tvSeries`, `short`, `tvEpisode`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `videoGame`, `video`, `musicVideo`, `podcastSeries`, `podcastEpisode`
genres	string	No	Comma-separated genres (include-only): `Action`, `Adventure`, `Animation`, `Biography`, `Comedy`, `Crime`, `Documentary`, `Drama`, `Family`, `Fantasy`, `Film-Noir`, `Game-Show`, `History`, `Horror`, `Music`, `Musical`, `Mystery`, `News`, `Reality-TV`, `Romance`, `Sci-Fi`, `Short`, `Sport`, `Talk-Show`, `Thriller`, `War`, `Western`
release_date_from	string	No	Release date lower bound: YYYY, YYYY-MM, or YYYY-MM-DD
release_date_to	string	No	Release date upper bound: YYYY, YYYY-MM, or YYYY-MM-DD
min_user_rating	number	No	Minimum IMDb user rating, 0-10
max_user_rating	number	No	Maximum IMDb user rating, 0-10
min_votes	integer	No	Minimum number of user rating votes
max_votes	integer	No	Maximum number of user rating votes
min_popularity	integer	No	Minimum IMDb popularity rank (1 is most popular)
max_popularity	integer	No	Maximum IMDb popularity rank
min_runtime	integer	No	Minimum runtime in minutes
max_runtime	integer	No	Maximum runtime in minutes
groups	string	No	Comma-separated awards/curated-list groups: `oscar_winner`, `oscar_nominee`, `emmy_winner`, `emmy_nominee`, `golden_globe_winner`, `golden_globe_nominee`, `best_picture_winner`, `best_director_winner`, `razzie_winner`, `razzie_nominee`, `top_100`, `top_250`, `top_1000`, `bottom_100`, `bottom_250`, `bottom_1000`
keywords	string	No	Comma-separated plot keywords
companies	string	No	Comma-separated IMDb company ids, format `co########`
certificates	string	No	Comma-separated `COUNTRY:RATING` certificate pairs, e.g. `US:PG-13`
colors	string	No	Comma-separated color info: `color`, `black_and_white`, `colorized`, `aces`
countries	string	No	Comma-separated ISO country codes
languages	string	No	Comma-separated ISO language codes
sound_mixes	string	No	Comma-separated sound mix names: `12-Track Digital Sound`, `3 Channel Stereo`, `4-Track Stereo`, `6-Track Stereo`, `70 mm 6-Track`, `AGA Sound System`, `Auro 11.1`, `CDS`, `Chronophone`, `Cinematophone`, `Cinephone`, `Cinerama 7-Track`, `Cinesound`, `D-Cinema 48kHz 5.1`, `Datasat`, `De Forest Phonofilm`, `Digitrac Digital Audio System`, `Dolby`, `Dolby Atmos`, `Dolby Digital`, `Dolby Digital EX`, `Dolby SR`, `Dolby Stereo`, `Dolby Surround 7.1`, `DTS`, `DTS 70 mm`, `DTS Stereo`, `DTS-ES`, `IMAX 6-Track`, `Kinoplasticon`, `LC-Concept Digital Sound`, `Matrix Surround`, `Mono`, `Perspecta Stereo`, `Phono-Kinema`, `SDDS`, `Sensurround`, `Silent`, `Sonics-DDP`, `Sonix`, `Stereo`, `Ultra Stereo`, `Vitaphone`
role	string	No	Comma-separated cast/crew IMDb name ids, format `nm########`
characters	string	No	Comma-separated character names
plot	string	No	Plot text search term
include_adult	boolean	No	Include adult titles. Defaults to excluded
sort	string	No	One of `moviemeter`, `alpha`, `user_rating`, `num_votes`, `boxoffice_gross_us`, `runtime`, `year`, `release_date`
sort_order	string	No	`asc` or `desc`. Defaults to `asc` when sort is set
limit	integer	No	Rows to return, default 25, max 50

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C",
    "fetched_at": "2026-08-01T12:00:00Z",
    "limit": 25,
    "total": 1968,
    "has_more": true,
    "results": [
      {
        "id": "tt33175825",
        "title": "Attack on Titan: The Last Attack",
        "url": "https://www.imdb.com/title/tt33175825/",
        "title_type": "movie",
        "year": 2024,
        "release_date": "2024-11-08",
        "genres": [
          "Animation",
          "Action",
          "Adventure"
        ],
        "rating_value": 9,
        "rating_count": 33724,
        "runtime_minutes": 145,
        "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans."
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

20 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestimdb.searchTitleResponseDocIMDb

GET /imdb/search/title

IMDb advanced title search

Returns normalized IMDb advanced title-search results (imdb.com/search/title/) from a credential-free public IMDb page. At least one filter is required; sort/limit alone are not enough. Limit defaults to 25 and clamps to 50; only IMDb's first rendered 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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C",
    "fetched_at": "2026-08-01T12:00:00Z",
    "limit": 25,
    "total": 1968,
    "has_more": true,
    "results": [
      {
        "id": "tt33175825",
        "title": "Attack on Titan: The Last Attack",
        "url": "https://www.imdb.com/title/tt33175825/",
        "title_type": "movie",
        "year": 2024,
        "release_date": "2024-11-08",
        "genres": [
          "Animation",
          "Action",
          "Adventure"
        ],
        "rating_value": 9,
        "rating_count": 33724,
        "runtime_minutes": 145,
        "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans."
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /imdb/search/title
Authentication: apiKey
Credit cost: 3 credits/request
Platform: IMDb
Parameters: 29 documented fields

Request parameters

title:querytitle_type:querygenres:queryrelease_date_from:queryrelease_date_to:querymin_user_rating:querymax_user_rating:querymin_votes:querymax_votes:querymin_popularity:querymax_popularity:querymin_runtime:query+17 more

Response schema fields

codedatadata.fetched_atdata.has_moredata.limitdata.resultsdata.results[].certificatedata.results[].genresdata.results[].iddata.results[].image_urldata.results[].metascoredata.results[].plot

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C",
    "fetched_at": "2026-08-01T12:00:00Z",
    "limit": 25,
    "total": 1968,
    "has_more": true,
    "results": [
      {
        "id": "tt33175825",
        "title": "Attack on Titan: The Last Attack",
        "url": "https://www.imdb.com/title/tt33175825/",
        "title_type": "movie",
        "year": 2024,
        "release_date": "2024-11-08",
        "genres": [
          "Animation",
          "Action",
          "Adventure"
        ],
        "rating_value": 9,
        "rating_count": 33724,
        "runtime_minutes": 145,
        "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans."
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/imdb/search/title" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing IMDb name detail IMDb name awards IMDb name credits IMDb title search IMDb title detail

Try the IMDb advanced title search API

Endpoint facts

Method: GET
API path: /imdb/search/title
Platform: IMDb
Auth: apiKey
Credits: 3 credits/request
Required params: None
Common optional params: title, title_type, genres, release_date_from, release_date_to, min_user_rating

Prefilled cURL

curl "https://api.crawlora.net/api/v1/imdb/search/title" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
title	string	No	Title-name substring match
title_type	string	No	Comma-separated title types: `feature`, `tvSeries`, `short`, `tvEpisode`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `tvShort`, `videoGame`, `video`, `musicVideo`, `podcastSeries`, `podcastEpisode`
genres	string	No	Comma-separated genres (include-only): `Action`, `Adventure`, `Animation`, `Biography`, `Comedy`, `Crime`, `Documentary`, `Drama`, `Family`, `Fantasy`, `Film-Noir`, `Game-Show`, `History`, `Horror`, `Music`, `Musical`, `Mystery`, `News`, `Reality-TV`, `Romance`, `Sci-Fi`, `Short`, `Sport`, `Talk-Show`, `Thriller`, `War`, `Western`
release_date_from	string	No	Release date lower bound: YYYY, YYYY-MM, or YYYY-MM-DD
release_date_to	string	No	Release date upper bound: YYYY, YYYY-MM, or YYYY-MM-DD
min_user_rating	number	No	Minimum IMDb user rating, 0-10
max_user_rating	number	No	Maximum IMDb user rating, 0-10
min_votes	integer	No	Minimum number of user rating votes
max_votes	integer	No	Maximum number of user rating votes
min_popularity	integer	No	Minimum IMDb popularity rank (1 is most popular)
max_popularity	integer	No	Maximum IMDb popularity rank
min_runtime	integer	No	Minimum runtime in minutes
max_runtime	integer	No	Maximum runtime in minutes
groups	string	No	Comma-separated awards/curated-list groups: `oscar_winner`, `oscar_nominee`, `emmy_winner`, `emmy_nominee`, `golden_globe_winner`, `golden_globe_nominee`, `best_picture_winner`, `best_director_winner`, `razzie_winner`, `razzie_nominee`, `top_100`, `top_250`, `top_1000`, `bottom_100`, `bottom_250`, `bottom_1000`
keywords	string	No	Comma-separated plot keywords
companies	string	No	Comma-separated IMDb company ids, format `co########`
certificates	string	No	Comma-separated `COUNTRY:RATING` certificate pairs, e.g. `US:PG-13`
colors	string	No	Comma-separated color info: `color`, `black_and_white`, `colorized`, `aces`
countries	string	No	Comma-separated ISO country codes
languages	string	No	Comma-separated ISO language codes
sound_mixes	string	No	Comma-separated sound mix names: `12-Track Digital Sound`, `3 Channel Stereo`, `4-Track Stereo`, `6-Track Stereo`, `70 mm 6-Track`, `AGA Sound System`, `Auro 11.1`, `CDS`, `Chronophone`, `Cinematophone`, `Cinephone`, `Cinerama 7-Track`, `Cinesound`, `D-Cinema 48kHz 5.1`, `Datasat`, `De Forest Phonofilm`, `Digitrac Digital Audio System`, `Dolby`, `Dolby Atmos`, `Dolby Digital`, `Dolby Digital EX`, `Dolby SR`, `Dolby Stereo`, `Dolby Surround 7.1`, `DTS`, `DTS 70 mm`, `DTS Stereo`, `DTS-ES`, `IMAX 6-Track`, `Kinoplasticon`, `LC-Concept Digital Sound`, `Matrix Surround`, `Mono`, `Perspecta Stereo`, `Phono-Kinema`, `SDDS`, `Sensurround`, `Silent`, `Sonics-DDP`, `Sonix`, `Stereo`, `Ultra Stereo`, `Vitaphone`
role	string	No	Comma-separated cast/crew IMDb name ids, format `nm########`
characters	string	No	Comma-separated character names
plot	string	No	Plot text search term
include_adult	boolean	No	Include adult titles. Defaults to excluded
sort	string	No	One of `moviemeter`, `alpha`, `user_rating`, `num_votes`, `boxoffice_gross_us`, `runtime`, `year`, `release_date`
sort_order	string	No	`asc` or `desc`. Defaults to `asc` when sort is set
limit	integer	No	Rows to return, default 25, max 50

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C",
    "fetched_at": "2026-08-01T12:00:00Z",
    "limit": 25,
    "total": 1968,
    "has_more": true,
    "results": [
      {
        "id": "tt33175825",
        "title": "Attack on Titan: The Last Attack",
        "url": "https://www.imdb.com/title/tt33175825/",
        "title_type": "movie",
        "year": 2024,
        "release_date": "2024-11-08",
        "genres": [
          "Animation",
          "Action",
          "Adventure"
        ],
        "rating_value": 9,
        "rating_count": 33724,
        "runtime_minutes": 145,
        "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans."
      }
    ]
  }
}

IMDb advanced title search

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C", "fetched_at": "2026-08-01T12:00:00Z", "limit": 25, "total": 1968, "has_more": true, "results": [ { "id": "tt33175825", "title": "Attack on Titan: The Last Attack", "url": "https://www.imdb.com/title/tt33175825/", "title_type": "movie", "year": 2024, "release_date": "2024-11-08", "genres": [ "Animation", "Action", "Adventure" ], "rating_value": 9, "rating_count": 33724, "runtime_minutes": 145, "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans." } ] } }

Endpoint details

Method: GET
Path: /imdb/search/title
Authentication: apiKey
Credit cost: 3 credits/request
Platform: IMDb
Parameters: 29 documented fields

Request parameters

Response schema fields

codedatadata.fetched_atdata.has_moredata.limitdata.resultsdata.results[].certificatedata.results[].genresdata.results[].iddata.results[].image_urldata.results[].metascoredata.results[].plot

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature&sort=user_rating%2Cdesc&num_votes=25000%2C",
    "fetched_at": "2026-08-01T12:00:00Z",
    "limit": 25,
    "total": 1968,
    "has_more": true,
    "results": [
      {
        "id": "tt33175825",
        "title": "Attack on Titan: The Last Attack",
        "url": "https://www.imdb.com/title/tt33175825/",
        "title_type": "movie",
        "year": 2024,
        "release_date": "2024-11-08",
        "genres": [
          "Animation",
          "Action",
          "Adventure"
        ],
        "rating_value": 9,
        "rating_count": 33724,
        "runtime_minutes": 145,
        "plot": "The fate of the world hangs in the balance as Eren unleashes the ultimate power of the Titans."
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/imdb/search/title" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing IMDb name detail IMDb name awards IMDb name credits IMDb title search IMDb title detail