Advanced movie search
Spotlite::Movie.search
method allows you to perform search queries with a variety of parameters.
Spotlite::Movie.search({groups: 'top_250', sort: 'user_rating,desc'})
Spotlite::Movie.search({groups: 'now_playing_us', release_date: '2014-04,2014-06', user_rating: '6.0,', num_votes: 10000})
Spotlite::Movie.search({genres: 'crime,drama', countries: 'us', release_date: '1990,1999', keywords: 'mafia', count: 50})
Spotlite::Movie.search({release_date: '1994', boxoffice_gross_us: '100000000,', sort: 'boxoffice_gross_us,desc'})
Spotlite::Movie.search({keywords: 'christmas-party,blood,island'})
How many results to show per page
Valid values: 50
, 100
, and 250
Integer. From where to start the title listing. count: 100, start: 101
will get the second page of results
Valid values: 'moviemeter[,asc|desc]'
, 'alpha[,asc|desc]'
, 'user_rating[,asc|desc]'
, 'num_votes[,asc|desc]'
, 'boxoffice_gross_us[,asc|desc]'
, 'runtime[,asc|desc]'
, 'year[,asc|desc]'
, 'release_date_us[,asc|desc]'
Default is 'moviemeter,asc'
, i.e. sorted by current popularity from most to least popular (1..n, 1 being the most popular)
The title (couldn't be more obvious, right?). Note, that the search is not performed on movie alternative titles
Valid values: '[,]YYYY[-MM[-DD]][,][YYYY[-MM[-DD]]]'
Examples:
-
'2010'
: movies released only in 2010 -
'2010-10'
: movies released only in October of 2010 -
'2010-10-20'
: movies released only on October 20, 2010 -
'2010-10,'
: movies released from October 2010 onward -
',2010-10'
: movies released until October 2010 inclusive -
'2010-01,2012-12'
: movies released from January 2010 to December 2012
Valid values: '[,]n[.n][,][n[.n]]'
, where n
is 0..10, can be integer or decimal
Examples:
-
'7.5'
: only with rating 7.5 -
'7,'
: with rating from 7 to 10 -
',3'
: with rating from 0 to 3 inclusive -
'8,9'
: with rating from 8 to 9 inclusive
Valid values: '[,]n[,][n]'
, where n
is >= 1, can only be integer
Examples:
-
'3000'
: with exactly 3000 user votes -
'5000,'
: with 5000 and more user votes -
',3000'
: with up to 3000 user votes inclusive -
'5000,10000'
: with 5000 to 10000 user votes inclusive
Format: 'genre1[,genre2[,genreN]]'
Valid values: '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'
, 'sport'
, 'talk_show'
, 'thriller'
, 'war'
, 'western'
Search is performed using boolean AND logic when multiple genres are provided
Format: 'keyword1[,keyword2[,keywordN]]'
Search is performed using boolean AND logic when multiple keywords are provided. Multi-worded keywords are separated by hyphen.
Predefined title groups.
Format: 'group1[,group2[,groupN]]'
Valid values: 'top_100'
, 'top_250'
, 'top_1000'
, 'now-playing-us'
, 'oscar_winners'
, 'oscar_best_picture_winners'
, 'oscar_best_director_winners'
, 'oscar_nominees'
, 'emmy_winners'
, 'emmy_nominees'
, 'golden_globe_winners'
, 'golden_globe_nominees'
, 'razzie_winners'
, 'razzie_nominees'
, 'national_film_registry'
, 'bottom_100'
, 'bottom_250'
, 'bottom_1000'
Search is performed using boolean AND logic when multiple groups are provided
Format: 'company1[,company2[,companyN]]'
Valid values: 'fox'
, 'columbia'
, 'dreamworks'
, 'mgm'
, 'paramount'
, 'universal'
, 'disney'
, 'warner'
Search is performed using boolean AND logic when multiple companies are provided
US box office gross
Valid values: '[,]n[,][n]'
, where n
is >= 1, can only be integer
Examples:
-
'3000000'
: with exactlly 3,000,000 USD -
'5000000,'
: with 5,000,000 USD and more -
',3000000'
: with up to 3,000,000 USD inclusive -
'5000000,10000000'
: with 5,000,000 to 10,000,000 USD inclusive
US MPAA certificates.
Valid values: 'us:g'
, 'us:pg'
, 'us:pg_13'
, 'us:r'
, 'us:nc_17'
Valid values: 'color'
, 'black_and_white'
, 'colorized'
Search by 2-symbol country codes of country of origin
Format: 'country_code1[,country_code2[,country_codeN]]'
Most common country codes: 'ar'
(Argentina), 'au'
(Australia), 'at'
(Austria), 'be'
(Belgium), 'br'
(Brazil), 'bg'
(Bulgaria), 'ca'
(Canada), 'cn'
(China), 'co'
(Colombia), 'cr'
(Costa Rica), 'cz'
(Czech Republic), 'dk'
(Denmark), 'fi'
(Finland), 'fr'
(France), 'de'
(Germany), 'gr'
(Greece), 'hk'
(Hong Kong), 'hu'
(Hungary), 'is'
(Iceland), 'in'
(India), 'ir'
(Iran), 'ie'
(Ireland), 'it'
(Italy), 'jp'
(Japan), 'my'
(Malaysia), 'mx'
(Mexico), 'nl'
(Netherlands), 'nz'
(New Zealand), 'pk'
(Pakistan), 'pl'
(Poland), 'pt'
(Portugal), 'ro'
(Romania), 'ru'
(Russia), 'sg'
(Singapore), 'za'
(South Africa), 'es'
(Spain), 'suhh'
(Soviet Union), 'se'
(Sweden), 'ch'
(Switzerland), 'th'
(Thailand), 'gb'
(United Kingdom), 'us'
(United States)
Search is performed using boolean AND logic when multiple country codes are provided
Search by 2-symbol language codes
Format: 'language_code1[,language_code2[,language_codeN]]'
Most common language codes: 'ar'
(Arabic), 'bg'
(Bulgarian), 'zh'
(Chinese), 'hr'
(Croatian), 'nl'
(Dutch), 'en'
(English), 'fi'
(Finnish), 'fr'
(French), 'de'
(German), 'el'
(Greek), 'he'
(Hebrew), 'hi'
(Hindi), 'hu'
(Hungarian), 'is'
(Icelandic), 'it'
(Italian), 'ja'
(Japanese), 'ko'
(Korean), 'no'
(Norwegian), 'fa'
(Persian), 'pl'
(Polish), 'pt'
(Portuguese), 'pa'
(Punjabi), 'ro'
(Romanian), 'ru'
(Russian), 'es'
(Spanish), 'sv'
(Swedish), 'tr'
(Turkish), 'uk'
(Ukrainian)
Search is performed using boolean AND logic when multiple language codes are provided
Valid values: 'released'
, 'post_production'
, 'filming'
, 'pre_production'
, 'completed'
, 'script'
, 'optioned_property'
, 'announced'
, 'treatment_outline'
, 'pitch'
, 'turnaround'
, 'abandoned'
, 'delayed'
, 'indefinitely_delayed'
, 'active'
, 'unknown'
Runtime in minutes
Valid values: '[,]n[,][n]'
, where n
is >= 1, can only be integer
Examples:
-
'130'
: exactly 130 minutes -
'90,'
: 90 minutes and more -
',100'
: up to 100 minutes inclusive -
'90,120'
: 90 to 120 minutes inclusive
Valid values: 'mono'
, 'silent'
, 'stereo'
, 'dolby_digital'
, 'dolby'
, 'dolby_sr'
, 'dts'
, 'sdds'
, 'ultra_stereo'
, '4_track_stereo'
, '70_mm_6_track'
, 'vitaphone'
, 'dolby_digital_ex'
, 'de_forest_phonofilm'
, 'dts_stereo'
, 'chronophone'
, '6_track_stereo'
, 'dts_es'
, 'perspecta_stereo'
, 'cinephone'
, '3_channel_stereo'
, 'cinematophone'
, 'sonics_ddp'
, '12_track_digital_sound'
, 'dts_70_mm'
, 'imax_6_track'
, 'matrix_surround'
, 'sonix'
, 'sensurround'
, 'cinerama_7_track'
, 'kinoplasticon'
, 'digitrac_digital_audio_system'
, 'cinesound'
, 'phono_kinema'
, 'cds'
Search is performed using boolean AND logic when multiple values are provided
Valid values: 'feature'
, 'tv_movie'
, 'tv_series'
, 'tv_episode'
, 'tv_special'
, 'mini_series'
, 'documentary'
, 'game'
, 'short'
, 'video'
, 'unknown'
Default is 'feature'
, i.e. regular movies
Valid values: 'simple'
, 'full'
Default is simple. Do not override this parameter, as parsing will fail with the full view