google_search_results 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad56c82937a90531cdebbddfa443885bb58848e8b165387263a72968e656a8aa
-  data.tar.gz: be506a5558ad74878c37faac39eb2477b377547e63cba06e631e7c4f83145806
+  metadata.gz: c9850029f90956175395320f506e034bf6373397954c31452cef7e4fbe56d46d
+  data.tar.gz: '082c1dc59ab2526df21009b2bf127378c76039c828a7bee459b8efd1f8e9c58b'
 SHA512:
-  metadata.gz: b39e137c299bb240a5194af347917170b85754394ef793f57c2843d9d0dced7558aef2a37ad907e431eeebbd558fd0f93ab40212d5a214a75b66ff5b50479e47
-  data.tar.gz: cab293e5a8883b81403fe802d59a4dfcf5078e822dddd62503e5b9ea46335b186e0bb50ea1cdc4838a80bb1db434a6feb6acae6831b27c44e0cfffd83885c495
+  metadata.gz: 810293f9210d09d120d50123cf593d42c958204beb7154922f839ca217dd8d093518401fd59a1842f06e6e67b5e18b9cc16984b2df6bdd0d43a4f98508304cfa
+  data.tar.gz: e2aedc34c37f8b4779651e475c3b21011680d783686557bb562bdb546b98bf074f31256933aad066e21ce78988696bade30630e4690290e494e0d3dc291d2634

data/lib/google_search_results.rb

@@ -5,3 +5,7 @@ require_relative 'search/ebay_search.rb'
 require_relative 'search/google_search.rb'
 require_relative 'search/yahoo_search.rb'
 require_relative 'search/yandex_search.rb'
+require_relative 'search/youtube_search.rb'
+require_relative 'search/walmart_search.rb'
+require_relative 'search/duckduckgo_search.rb'
+require_relative 'search/homedepot_search.rb'

data/lib/search/baidu_search.rb

@@ -22,12 +22,12 @@ require_relative 'serp_api_search'
 class BaiduSearch < SerpApiSearch
 
   def initialize(params = {})
-    super(params, BING_ENGINE)
+    super(params, BAIDU_ENGINE)
     check_params([:q, :engine])
   end
 
   def get_location
-    raise 'location is not supported by Baidu'
+    raise SerpApiException.new('location is not supported by Baidu')
   end
 
 end

data/lib/search/duckduckgo_search.rb

@@ -0,0 +1,29 @@
+require_relative 'serp_api_search'
+
+# Duckduckgo Search Result for Ruby powered by SerpApi
+#
+# Search API Usage
+#
+# ```ruby
+# parameter = {
+#   search_query: "query",
+#   api_key: "Serp API Key"
+# }
+#
+# search = DuckduckgoSearch.new(parameter)
+#
+# html_results = search.get_html
+# hash_results = search.get_hash
+# json_results = search.get_json
+#
+# ```
+# doc: https://serpapi.com/Duckduckgo-search-api
+
+class DuckduckgoSearch < SerpApiSearch
+
+  def initialize(params = {})
+    super(params, DUCKDUCKGO_ENGINE)
+    check_params([:q, :engine])
+  end
+
+end

data/lib/search/ebay_search.rb

@@ -29,7 +29,7 @@ class EbaySearch < SerpApiSearch
   end
 
   def get_location
-    raise 'location is not supported by ' + EBAY_ENGINE
+    raise SerpApiException.new('location is not supported by ' + EBAY_ENGINE)
   end
 
 end

data/lib/search/homedepot_search.rb

@@ -0,0 +1,33 @@
+require_relative 'serp_api_search'
+
+# Homedepot Search Result for Ruby powered by SerpApi
+#
+# Search API Usage
+#
+# ```ruby
+# parameter = {
+#   search_query: "query",
+#   api_key: "Serp API Key"
+# }
+#
+# search = HomedepotSearch.new(parameter)
+#
+# html_results = search.get_html
+# hash_results = search.get_hash
+# json_results = search.get_json
+#
+# ```
+# doc: https://serpapi.com/Homedepot-search-api
+
+class HomedepotSearch < SerpApiSearch
+
+  def initialize(params = {})
+    super(params, HOMEDEPOT_ENGINE)
+    check_params([:q, :engine])
+  end
+
+  def get_location
+    raise SerpApiException.new('location is not supported by Homedepot')
+  end
+
+end

data/lib/search/serp_api_search.rb

@@ -7,13 +7,16 @@ BING_ENGINE = 'bing'
 YAHOO_ENGINE = 'yahoo'
 YANDEX_ENGINE = 'yandex'
 EBAY_ENGINE = 'ebay'
-
+YOUTUBE_ENGINE = 'youtube'
+DUCKDUCKGO_ENGINE = 'duckduckgo'
+WALMART_ENGINE = 'walmart'
+HOMEDEPOT_ENGINE = 'home_depot'
 
 # Generic HTTP client for serpapi.com
 #
 class SerpApiSearch
 
-  VERSION = "2.0.1"
+  VERSION = "2.1.0"
   BACKEND = "serpapi.com"
 
   attr_accessor :params
@@ -34,7 +37,7 @@ class SerpApiSearch
   def initialize(params, engine = nil)
     @params = params
     @params[:engine] ||= engine
-    raise 'engine must be defined in params or a second argument' if @params[:engine].nil?
+    raise SerpApiException.new('engine must be defined in params or a second argument') if @params[:engine].nil?
   end
 
   # get_json 
@@ -78,7 +81,7 @@ class SerpApiSearch
 
   # Retrieve search result from the Search Archive API
   def get_search_archive(search_id, format = 'json')
-    raise 'format must be json or html' if format !~ /^(html|json)$/
+    raise SerpApiException.new('format must be json or html') if format !~ /^(html|json)$/
     as_json(get_results("/searches/#{search_id}.#{format}"))
   end
 
@@ -149,7 +152,7 @@ class SerpApiSearch
   def check_params(keys = [])
     return if @params.keys == [:engine]
 
-    raise 'keys must be a list of String or Symbol' unless keys.class == Array
+    raise SerpApiException.new('keys must be a list of String or Symbol') unless keys.class == Array
     missing = []
     keys.each do |key|
       case key.class.to_s
@@ -166,13 +169,19 @@ class SerpApiSearch
           end
         end
       else
-        raise 'keys must contains Symbol or String'
+        raise SerpApiException.new('keys must contains Symbol or String')
       end
     end
     if !missing.empty?
-      raise "missing required keys in params.\n #{missing.join(',')}"
+      raise SerpApiException.new("missing required keys in params.\n #{missing.join(',')}")
     end
   end
 
 end
 
+# Standard SerpApiException for anything related to the client
+class SerpApiException < StandardError
+  def initialize(message)
+    super(message)
+  end
+end

data/lib/search/walmart_search.rb

@@ -0,0 +1,33 @@
+require_relative 'serp_api_search'
+
+# Walmart Search Result for Ruby powered by SerpApi
+#
+# Search API Usage
+#
+# ```ruby
+# parameter = {
+#   query: "search keywords",
+#   api_key: "Serp API Key"
+# }
+#
+# search = WalmartSearch.new(parameter)
+#
+# html_results = search.get_html
+# hash_results = search.get_hash
+# json_results = search.get_json
+#
+# ```
+# doc: https://serpapi.com/youtube-search-api
+
+class WalmartSearch < SerpApiSearch
+
+  def initialize(params = {})
+    super(params, WALMART_ENGINE)
+    check_params([:query, :engine])
+  end
+
+  def get_location
+    raise SerpApiException.new('location is not supported by Walmart')
+  end
+
+end

data/lib/search/yahoo_search.rb

@@ -29,7 +29,7 @@ class YahooSearch < SerpApiSearch
   end
 
   def get_location
-    raise 'location is not supported by ' + YAHOO_ENGINE
+    raise SerpApiException.new('location is not supported by ' + YAHOO_ENGINE)
   end
 
 end

data/lib/search/yandex_search.rb

@@ -29,7 +29,7 @@ class YandexSearch < SerpApiSearch
   end
 
   def get_location
-    raise 'location is not supported by ' + YAHOO_ENGINE
+    raise SerpApiException.new('location is not supported by ' + YAHOO_ENGINE)
   end
 
 end

data/lib/search/youtube_search.rb

@@ -0,0 +1,29 @@
+require_relative 'serp_api_search'
+
+# Youtube Search Result for Ruby powered by SerpApi
+#
+# Search API Usage
+#
+# ```ruby
+# parameter = {
+#   search_query: "query",
+#   api_key: "Serp API Key"
+# }
+#
+# search = YoutubeSearch.new(parameter)
+#
+# html_results = search.get_html
+# hash_results = search.get_hash
+# json_results = search.get_json
+#
+# ```
+# doc: https://serpapi.com/youtube-search-api
+
+class YoutubeSearch < SerpApiSearch
+
+  def initialize(params = {})
+    super(params, YOUTUBE_ENGINE)
+    check_params([:search_query, :engine])
+  end
+
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: google_search_results
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - hartator
 - jvmvik
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-22 00:00:00.000000000 Z
+date: 2021-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -77,17 +77,21 @@ files:
 - lib/google_search_results.rb
 - lib/search/baidu_search.rb
 - lib/search/bing_search.rb
+- lib/search/duckduckgo_search.rb
 - lib/search/ebay_search.rb
 - lib/search/google_search.rb
+- lib/search/homedepot_search.rb
 - lib/search/serp_api_search.rb
+- lib/search/walmart_search.rb
 - lib/search/yahoo_search.rb
 - lib/search/yandex_search.rb
+- lib/search/youtube_search.rb
 homepage: https://github.com/serpapi/google-search-results-ruby
 licenses:
 - MIT
 metadata:
   yard.run: yri
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -102,8 +106,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key:
+rubygems_version: 3.0.3
+signing_key: 
 specification_version: 4
 summary: Get Google, Bing, Baidu, Ebay, Yahoo, Yandex Search Results via SerpApi.com
 test_files: []