Skip to content

IMDb Search

Finds every item using an IMDb Advance Title Search.

The sync_mode: sync and collection_order: custom Setting are recommended since the lists are continuously updated and in a specific order.

Warning

We strongly recommend you use the IMDb Search website to manually verify that the options you have selected are valid.

You can also view the available keywords on the IMDb Keyword Search page.

Search Parameter Description
limit Specify how items you want returned by the query.
Options: Any Integer 0 or greater where 0 get all items.
Default: 100
sort_by Choose from one of the many available sort options.
Options: popularity.asc, popularity.desc, title.asc, title.desc, rating.asc, rating.desc, votes.asc, votes.desc, box_office.asc, box_office.desc, runtime.asc, runtime.desc, year.asc, year.desc, release.asc, release.desc
Default: popularity.asc
title Search by title name.
Options: Any String
type Item must match at least one given type. Can be a comma-separated list.
Options: movie, tv_series, short, tv_episode, tv_mini_series, tv_movie, tv_special, tv_short, video_game, video, music_video, podcast_series, podcast_episode
type.not Item must not match any of the given types. Can be a comma-separated list.
Options: movie, tv_series, short, tv_episode, tv_mini_series, tv_movie, tv_special, tv_short, video_game, video, music_video, podcast_series, podcast_episode
release.after Item must have been released after the given date.
Options: today or Date in the format YYYY-MM-DD
release.before Item must have been released before the given date.
Options: today or Date in the format YYYY-MM-DD
rating.gte Item must have an IMDb Rating greater than or equal to the given number.
Options: Any Number 0.1 - 10.0
Example: 7.5
rating.lte Item must have an IMDb Rating less than or equal to the given number.
Options: Any Number 0.1 - 10.0
Example: 7.5
votes.gte Item must have a Number of Votes greater than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
votes.lte Item must have a Number of Votes less than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
genre Item must match all genres given. Can be a comma-separated list.
Options: action, adventure, animation, biography, comedy, documentary, drama, crime, family, history, news, short, western, sport, reality-tv, horror, fantasy, film-noir, music, romance, talk-show, thriller, war, sci-fi, musical, mystery, game-show
genre.any Item must match at least one given genre. Can be a comma-separated list.
Options: action, adventure, animation, biography, comedy, documentary, drama, crime, family, history, news, short, western, sport, reality-tv, horror, fantasy, film-noir, music, romance, talk-show, thriller, war, sci-fi, musical, mystery, game-show
genre.not Item must not match any of the given genres. Can be a comma-separated list.
Options: action, adventure, animation, biography, comedy, documentary, drama, crime, family, history, news, short, western, sport, reality-tv, horror, fantasy, film-noir, music, romance, talk-show, thriller, war, sci-fi, musical, mystery, game-show
interests Item must match all interests given. Can be a comma-separated list.
Options: see below Interests Options table
interests.any Item must match at least one given interest. Can be a comma-separated list.
Options: see below Interests Options table
interests.not Item must not match any of the given interests. Can be a comma-separated list.
Options: see below Interests Options table
event Item must have been nominated for a category at the event given. Can be a comma-separated list.
Options: cannes, choice, spirit, sundance, bafta, oscar, emmy, golden, oscar_picture, oscar_director, national_film_board_preserved, razzie, or any IMDb Event ID (ex. ev0050888)
event.winning Item must have won a category at the event given. Can be a comma-separated list.
Options: cannes, choice, spirit, sundance, bafta, oscar, emmy, golden, oscar_picture, oscar_director, national_film_board_preserved, razzie, or any IMDb Event ID (ex. ev0050888)
imdb_top Item must be in the top number of given Movies.
Options: Any Integer greater than 0
imdb_bottom Item must be in the bottom number of given Movies.
Options: Any Integer greater than 0
topic Item must match at least one given topic. Can be a comma-separated list.
Options: alternate_version, award, business_info, crazy_credit, goof, location, plot, quote, soundtrack, technical, trivia
topic.not Item must not match any of the given topic. Can be a comma-separated list.
Options: alternate_version, award, business_info, crazy_credit, goof, location, plot, quote, soundtrack, technical, trivia
alternate_version Item's Alternate Version must contain all the given strings. Can be a comma-separated list.
Options: Any String
alternate_version.any Item's Alternate Version must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
alternate_version.not Item's Alternate Version must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
crazy_credit Item's Crazy Credits must contain all the given strings. Can be a comma-separated list.
Options: Any String
crazy_credit.any Item's Crazy Credits must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
crazy_credit.not Item's Crazy Credits must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
location Item's Location must contain all the given strings. Can be a comma-separated list.
Options: Any String
location.any Item's Location must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
location.not Item's Location must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
goof Item's Goofs must contain all the given strings. Can be a comma-separated list.
Options: Any String
goof.any Item's Goofs must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
goof.not Item's Goofs must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
plot Item's Plot must contain all the given strings. Can be a comma-separated list.
Options: Any String
plot.any Item's Plot must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
plot.not Item's Plot must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
quote Item's Quote must contain all the given strings. Can be a comma-separated list.
Options: Any String
quote.any Item's Quote must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
quote.not Item's Quote must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
soundtrack Item's Soundtrack must contain all the given strings. Can be a comma-separated list.
Options: Any String
soundtrack.any Item's Soundtrack must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
soundtrack.not Item's Soundtrack must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
trivia Item's Trivia must contain all the given strings. Can be a comma-separated list.
Options: Any String
trivia.any Item's Trivia must contain at least one of the given strings. Can be a comma-separated list.
Options: Any String
trivia.not Item's Trivia must not contain any of the given strings. Can be a comma-separated list.
Options: Any String
company Item must have been released by any company given. Can be a comma-separated list.
Options: fox, dreamworks, mgm, paramount, sony, universal, disney, warner, or any IMDb Company ID (ex. co0023400)
content_rating Item must have the given content rating. Can be a list.
Options: Dictionary with two attributes rating and region
rating: Any String to match the content rating
region: 2 Digit ISO 3166 Country Code
country Item must match with every given country. Can be a comma-separated list.
Options: 2 Digit ISO 3166 Country Code
country.any Item must match at least one given country. Can be a comma-separated list.
Options: 2 Digit ISO 3166 Country Code
country.not Item must not match any given country. Can be a comma-separated list.
Options: 2 Digit ISO 3166 Country Code
country.origin Item must match any given country as the origin country. Can be a comma-separated list.
Options: 2 Digit ISO 3166 Country Code
keyword Item must match with every given keyword. Can be a comma-separated list.
Options: Any Valid IMDb Keyword
keyword.any Item must match at least one given keyword. Can be a comma-separated list.
Options: Any Valid IMDb Keyword
keyword.not Item must not match any given keyword. Can be a comma-separated list.
Options: Any Valid IMDb Keyword
series Item must match at least one given series. Can be a comma-separated list.
Options: Any IMDb ID (ex. tt0096697)
series.not Item must not match any given series. Can be a comma-separated list.
Options: Any IMDb ID (ex. tt0096697)
list Item must be on every given list. Can be a comma-separated list.
Options: Any IMDb List ID (ex. ls000024621)
list.any Item must be on at least one given lists. Can be a comma-separated list.
Options: Any IMDb List ID (ex. ls000024621)
list.not Item must not be on any given lists. Can be a comma-separated list.
Options: Any IMDb List ID (ex. ls000024621)
language Item must match any given language. Can be a comma-separated list.
Options: ISO 639-2 Language Codes
language.any Item must match at least one given language. Can be a comma-separated list.
Options: ISO 639-2 Language Codes
language.not Item must not match any given language. Can be a comma-separated list.
Options: ISO 639-2 Language Codes
language.primary Item must match any given language as the primary language. Can be a comma-separated list.
Options: ISO 639-2 Language Codes
popularity.gte Item must have a Popularity greater than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
popularity.lte Item must have a Popularity less than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
cast Item must have all the given cast members. Can be a comma-separated list.
Options: Any IMDb Person ID (ex. nm0000138)
cast.any Item must have any of the given cast members. Can be a comma-separated list.
Options: Any IMDb Person ID (ex. nm0000138)
cast.not Item must not have any of the given cast members. Can be a comma-separated list.
Options: Any IMDb Person ID (ex. nm0000138)
character Item must have any of the given character listed in its credits. Can be a comma-separated list.
Options: Any String
runtime.gte Item must have a Runtime greater than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
runtime.lte Item must have a Runtime less than or equal to the given number.
Options: Any Integer greater than 0
Example: 1000
adult Include adult titles in the search results.
Options: true/false
Interests Options (Click to Expand)

You can use the Key or the ID for interests. This list is a snapshot; IMDb's interest catalog changes over time, and Kometa refreshes it automatically from INTERESTS.json at runtime (falling back to a bundled copy). That file is the authoritative, always-current list.

Name Key ID
90 Day Fiancé 90_day_fiancé in0000262
Action action in0000001
Action Epic action_epic in0000002
Adult Animation adult_animation in0000025
Adventure adventure in0000012
Adventure Epic adventure_epic in0000015
Alien alien in0000265
Alien Invasion alien_invasion in0000157
Animal Adventure animal_adventure in0000092
Animation animation in0000026
Anime anime in0000027
Arabic arabic in0000213
Artificial Intelligence artificial_intelligence in0000158
Avatar: The Last Airbender avatar:_the_last_airbender in0000312
B-Action b_action in0000003
B-Horror b_horror in0000108
Baseball baseball in0000167
Basketball basketball in0000168
Battlestar Galactica battlestar_galactica in0000278
Beauty Competition beauty_competition in0000102
Beauty Makeover beauty_makeover in0000123
Bengali bengali in0000214
Big Brother big_brother in0000263
Biography biography in0000072
Blade Runner blade_runner in0000296
Body Horror body_horror in0000109
Body Swap Comedy body_swap_comedy in0000031
Boxing boxing in0000169
Breaking Bad breaking_bad in0000274
Buddy Comedy buddy_comedy in0000032
Buddy Cop buddy_cop in0000033
Buffyverse buffyverse in0000311
Bumbling Detective bumbling_detective in0000136
Business Reality TV business_reality_tv in0000142
Cantonese cantonese in0000215
Caper caper in0000050
Car Action car_action in0000004
Classic Musical classic_musical in0000131
Classical Western classical_western in0000187
Comedy comedy in0000034
Coming-of-Age coming_of_age in0000073
Computer Animation computer_animation in0000028
Concert concert in0000129
Conspiracy Thriller conspiracy_thriller in0000176
Contemporary Western contemporary_western in0000188
Cooking & Food cooking_&_food in0000124
Cooking Competition cooking_competition in0000103
Cop Drama cop_drama in0000051
Costume Drama costume_drama in0000074
Cozy Mystery cozy_mystery in0000137
Crime crime in0000052
Crime Documentary crime_documentary in0000059
Crime Reality TV crime_reality_tv in0000143
Cyber Thriller cyber_thriller in0000177
Cyberpunk cyberpunk in0000159
Danish danish in0000242
Dark Comedy dark_comedy in0000035
Dark Fantasy dark_fantasy in0000095
Dark Romance dark_romance in0000149
Dating Reality TV dating_reality_tv in0000144
DC dc in0000244
Degrassi degrassi in0000264
Desert Adventure desert_adventure in0000013
Despicable Me despicable_me in0000267
Dinosaur Adventure dinosaur_adventure in0000014
Disaster disaster in0000005
Doctor Who doctor_who in0000270
Docudrama docudrama in0000075
Documentary documentary in0000060
Docuseries docuseries in0000061
Docusoap Reality TV docusoap_reality_tv in0000145
Dragon Ball dragon_ball in0000250
Drama drama in0000076
Drug Crime drug_crime in0000053
Dune dune in0000297
Dutch dutch in0000216
Dystopian Sci-Fi dystopian_sci_fi in0000160
Epic epic in0000077
Erotic Thriller erotic_thriller in0000178
Evangelion evangelion in0000255
Evil Dead evil_dead in0000290
Extreme Sport extreme_sport in0000170
Fairy Tale fairy_tale in0000097
Faith & Spirituality Documentary faith_&_spirituality_documentary in0000062
Family family in0000093
Fantasy fantasy in0000098
Fantasy Epic fantasy_epic in0000096
Farce farce in0000036
Fast & Furious fast_&_furious in0000273
Feel-Good Romance feel_good_romance in0000151
Filipino filipino in0000217
Film Noir film_noir in0000054
Financial Drama financial_drama in0000078
Finnish finnish in0000218
Folk Horror folk_horror in0000110
Food Documentary food_documentary in0000063
Football football in0000171
Found Footage Horror found_footage_horror in0000111
French french in0000219
Frozen frozen in0000293
Game Show game_show in0000105
Gangster gangster in0000055
German german in0000220
Giallo giallo in0000179
Globetrotting Adventure globetrotting_adventure in0000016
Godzilla godzilla in0000285
Golmaal golmaal in0000306
Greek greek in0000221
Gun Fu gun_fu in0000197
Gundam gundam in0000256
Hand-Drawn Animation hand_drawn_animation in0000029
Hard-boiled Detective hard_boiled_detective in0000138
Harry Potter harry_potter in0000281
Heist heist in0000056
Hidden Camera hidden_camera in0000146
High-Concept Comedy high_concept_comedy in0000037
Hindi hindi in0000222
Historical Epic historical_epic in0000079
History history in0000080
History Documentary history_documentary in0000064
Holiday holiday in0000192
Holiday Animation holiday_animation in0000193
Holiday Comedy holiday_comedy in0000194
Holiday Family holiday_family in0000195
Holiday Romance holiday_romance in0000196
Home Improvement home_improvement in0000125
Horror horror in0000112
Housefull housefull in0000308
Indiana Jones indiana_jones in0000298
Isekai isekai in0000201
Italian italian in0000223
Iyashikei iyashikei in0000202
James Bond james_bond in0000266
Japanese japanese in0000224
Jason Statham Action jason_statham_action in0000315
John Wick john_wick in0000291
Josei josei in0000203
Jukebox Musical jukebox_musical in0000132
Jungle Adventure jungle_adventure in0000017
Jurassic Park jurassic_park in0000283
Kaiju kaiju in0000161
Kamen Rider kamen_rider in0000257
Kannada kannada in0000241
Korean korean in0000225
Korean Drama korean_drama in0000209
Kung Fu kung_fu in0000198
Kung Fu Panda kung_fu_panda in0000294
Legal Drama legal_drama in0000081
Legal Thriller legal_thriller in0000180
Lego lego in0000249
Lifestyle lifestyle in0000126
Love Is Blind love_is_blind in0000261
Love Island love_island in0000254
Maddock Horror Comedy Universe maddock_horror_comedy_universe in0000305
Malayalam malayalam in0000240
Mandarin mandarin in0000226
Marathi marathi in0000227
Martial Arts martial_arts in0000006
Marvel marvel in0000248
Masters of the Universe masters_of_the_universe in0000280
Mecha mecha in0000204
Medical Drama medical_drama in0000082
Micro-Drama micro_drama in0000310
Military Documentary military_documentary in0000065
Mission: Impossible mission:_impossible in0000284
Mockumentary mockumentary in0000038
Monster Horror monster_horror in0000113
Motorsport motorsport in0000172
Mountain Adventure mountain_adventure in0000018
Music music in0000130
Music Documentary music_documentary in0000066
Musical musical in0000133
Mystery mystery in0000139
Naruto naruto in0000258
Nature Documentary nature_documentary in0000067
News news in0000211
Norwegian norwegian in0000228
One Piece one_piece in0000251
One-Person Army Action one_person_army_action in0000007
Paranormal Reality TV paranormal_reality_tv in0000147
Parody parody in0000039
Period Drama period_drama in0000083
Persian persian in0000229
Pitch Perfect pitch_perfect in0000302
Planet of the Apes planet_of_the_apes in0000275
Pokémon pokémon in0000252
Police Procedural police_procedural in0000057
Political Documentary political_documentary in0000068
Political Drama political_drama in0000084
Political Thriller political_thriller in0000181
Pop Musical pop_musical in0000134
Portuguese portuguese in0000230
Power Rangers power_rangers in0000246
Predator predator in0000276
Prison Drama prison_drama in0000085
Psychological Drama psychological_drama in0000086
Psychological Horror psychological_horror in0000114
Psychological Thriller psychological_thriller in0000182
Punjabi punjabi in0000231
Quest quest in0000019
Quirky Comedy quirky_comedy in0000040
Quiz Show quiz_show in0000104
Raunchy Comedy raunchy_comedy in0000041
Reality TV reality_tv in0000148
Resident Evil resident_evil in0000314
Road Trip road_trip in0000020
Rock Musical rock_musical in0000135
Rohit Shetty Cop Universe rohit_shetty_cop_universe in0000307
Romance romance in0000152
Romantic Comedy romantic_comedy in0000153
Romantic Epic romantic_epic in0000150
RuPaul's Drag Race rupaul's_drag_race in0000253
Russian russian in0000232
Samurai samurai in0000199
Satire satire in0000042
Saw saw in0000277
Sci-Fi sci_fi in0000162
Sci-Fi Epic sci_fi_epic in0000163
Science & Technology Documentary science_&_technology_documentary in0000069
Scooby-Doo scooby_doo in0000309
Scream scream in0000292
Screwball Comedy screwball_comedy in0000043
Sea Adventure sea_adventure in0000021
Seinen seinen in0000205
Serial Killer serial_killer in0000183
Short short in0000212
Showbiz Drama showbiz_drama in0000087
Shrek shrek in0000268
Shōjo shōjo in0000207
Shōnen shōnen in0000206
Sitcom sitcom in0000044
Sketch Comedy sketch_comedy in0000045
Slapstick slapstick in0000046
Slasher Horror slasher_horror in0000115
Slice of Life slice_of_life in0000208
Soap Opera soap_opera in0000088
Soccer soccer in0000173
Space Sci-Fi space_sci_fi in0000164
Spaghetti Western spaghetti_western in0000190
Spanish spanish in0000233
Splatter Horror splatter_horror in0000116
SpongeBob SquarePants spongebob_squarepants in0000288
Sport sport in0000174
Sports Documentary sports_documentary in0000070
Spy spy in0000184
Spy Universe Yash Raj Films spy_universe_yash_raj_films in0000301
Stand-Up stand_up in0000047
Star Trek star_trek in0000247
Star Wars star_wars in0000243
Stargate stargate in0000295
Steampunk steampunk in0000165
Steamy Romance steamy_romance in0000154
Stoner Comedy stoner_comedy in0000048
Stop Motion Animation stop_motion_animation in0000030
Super Mario Bros super_mario_bros in0000299
Superhero superhero in0000008
Supernatural Fantasy supernatural_fantasy in0000099
Supernatural Horror supernatural_horror in0000117
Survival survival in0000185
Survival Competition survival_competition in0000106
Suspense Mystery suspense_mystery in0000140
Swashbuckler swashbuckler in0000022
Swedish swedish in0000234
Sword & Sandal sword_&_sandal in0000009
Sword & Sorcery sword_&_sorcery in0000100
Talent Competition talent_competition in0000107
Talk Show talk_show in0000127
Tamil tamil in0000235
Teen Adventure teen_adventure in0000023
Teen Comedy teen_comedy in0000049
Teen Drama teen_drama in0000089
Teen Fantasy teen_fantasy in0000101
Teen Horror teen_horror in0000118
Teen Romance teen_romance in0000155
Teenage Mutant Ninja Turtles teenage_mutant_ninja_turtles in0000271
Telenovela telenovela in0000210
Telugu telugu in0000236
Terminator terminator in0000286
Thai thai in0000237
The Addams Family the_addams_family in0000313
The Chronicles of Narnia the_chronicles_of_narnia in0000289
The Conjuring Universe the_conjuring_universe in0000287
The Hunger Games the_hunger_games in0000303
The Lord of the Rings the_lord_of_the_rings in0000279
The Matrix the_matrix in0000304
The Real Housewives the_real_housewives in0000269
The Walking Dead the_walking_dead in0000282
The Witcher the_witcher in0000300
Thriller thriller in0000186
Time Travel time_travel in0000166
Toy Story toy_story in0000272
Tragedy tragedy in0000090
Tragic Romance tragic_romance in0000156
Transformers transformers in0000245
Travel travel in0000128
Travel Documentary travel_documentary in0000071
True Crime true_crime in0000058
Turkish turkish in0000238
Urban Adventure urban_adventure in0000024
Urdu urdu in0000239
Vampire Horror vampire_horror in0000119
War war in0000010
War Epic war_epic in0000011
Water Sport water_sport in0000175
Werewolf Horror werewolf_horror in0000120
Western western in0000191
Western Epic western_epic in0000189
Whodunnit whodunnit in0000141
Witch Horror witch_horror in0000121
Workplace Drama workplace_drama in0000091
Wuxia wuxia in0000200
Yu-Gi-Oh! yu_gi_oh! in0000259
Zombie Horror zombie_horror in0000122

Example IMDb Search Builder(s)

collections:
  IMDb Popular:
    imdb_search:
      type: movie
      sort_by: popularity.asc
      limit: 50
    collection_order: custom
    sync_mode: sync
collections:
  Top Action:
    imdb_search:
      type: movie
      release.after: 1990-01-01
      rating.gte: 5
      votes.gte: 100000
      genre: action
      sort_by: rating.desc
      limit: 100

You can also find episodes using imdb_search like so.

collections:
  The Simpsons Top 100 Episodes:
    collection_order: custom
    builder_level: episode
    sync_mode: sync
    imdb_search:
      type: tv_episode
      series: tt0096697
      sort_by: rating.desc
      limit: 100
    summary: The top 100 Simpsons episodes by IMDb user rating