IMDb advanced title search
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.
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
Query parameters
Title-name substring match
Comma-separated title types: feature, tvSeries, short, tvEpisode, tvMiniSeries, tvMovie, tvSpecial, tvShort, videoGame, video, musicVideo, podcastSeries, podcastEpisode
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 lower bound: YYYY, YYYY-MM, or YYYY-MM-DD
Release date upper bound: YYYY, YYYY-MM, or YYYY-MM-DD
Minimum IMDb user rating, 0-10
Maximum IMDb user rating, 0-10
Minimum number of user rating votes
Maximum number of user rating votes
Minimum IMDb popularity rank (1 is most popular)
Maximum IMDb popularity rank
Minimum runtime in minutes
Maximum runtime in minutes
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
Comma-separated plot keywords
Comma-separated IMDb company ids, format co########
Comma-separated COUNTRY:RATING certificate pairs, e.g. US:PG-13
Comma-separated color info: color, black_and_white, colorized, aces
Comma-separated ISO country codes
Comma-separated ISO language codes
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
Comma-separated cast/crew IMDb name ids, format nm########
Comma-separated character names
Plot text search term
Include adult titles. Defaults to excluded
One of moviemeter, alpha, user_rating, num_votes, boxoffice_gross_us, runtime, year, release_date
asc or desc. Defaults to asc when sort is set
Rows to return, default 25, max 50
Headers
API key required
Response
OK
Example response
{
"code": 200,
"data": {
"fetched_at": "2026-06-07T14:46:16Z",
"has_more": true,
"limit": 25,
"results": [
{
"certificate": "PG-13",
"genres": [
"Action"
],
"id": "tt1375666",
"metascore": 74,
"rating_count": 2600000,
"rating_value": 8.8,
"release_date": "2010-07-16",
"runtime_minutes": 148,
"title": "Inception",
"title_type": "movie",
"url": "https://www.imdb.com/title/tt1375666/",
"year": 2010
}
],
"source_url": "https://www.imdb.com/search/title/?genres=Action&title_type=feature",
"total": 1968
},
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.