Module: Genius::Search

Defined in:

lib/genius/api/search.rb

Overview

Genius::Search module provides methods to work with Genius search database

Class Method Summary

• .search(token: nil, query: nil, search_by: nil) ⇒ Hash, ...

  Searches Genius for songs, artists, and other content.

Class Method Details

.search(token: nil, query: nil, search_by: nil) ⇒ Hash, ...

Searches Genius for songs, artists, and other content. Optionally filters results by key using deep_find.

Parameters:

• token (String?) (defaults to: nil) —

  Token to access api.genius.com.

• query (String?) (defaults to: nil) —

  Search query.

• search_by (String?) (defaults to: nil) —

  Key to filter results with Hash#deep_find.

Returns:

• (Hash, String, nil)

# File 'lib/genius/api/search.rb', line 13

def search(token: nil, query: nil, search_by: nil)
  return if token.nil? && !Auth.authorized?.nil?

  Errors.validate_token(token) unless token.nil?

  response = HTTParty.get("#{Api::RESOURCE}/search?q=#{query}&access_token=#{token_ext(token)}").body
  search = JSON.parse(response)
  search_by ? search.deep_find(search_by) : search
end