Module: TMDb::Searchable

Included in:
Movie, Person
Defined in:
lib/tmdb-api/searchable.rb

Instance Method Summary collapse

Instance Method Details

#search(query, options = {}) ⇒ Object

Public: Search resources like a movie, a person, a collection and so on.

For a movie query - Query string that will be matched with the movie name. options - The hash options used to filter the search (default: {}):

:page - The current page of results.
:language - Language of the result data (ISO 639-1 codes) (default: en).
:include_adult - Toggle the inclusion of adult titles. Expected value is: true or false.
:year - Filter results to only include this value.

Examples

For a movie

TMDb::Movie.search('Iron Man')
TMDb::Movie.search('The Matrix', year: 1999)
TMDb::Movie.search('Forret Gump', language: 'pt', year: 1994)

For a person

TMDb::Person.search('Peter Jackson')
TMDb::Person.search('Paul', page: 4)



23
24
25
26
27
28
29
30
31
 
# File 'lib/tmdb-api/searchable.rb', line 23

def search(query, options = {})
  options.merge!(query: query)
  res = get("/search/#{resource}", query: options)
  if res.success?
    res['results'].map { |attributes| new(attributes) }
  else
    bad_response(res)
  end
end