searchapi-ruby 0.1.0

data/lib/searchapi/client.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/retry"
+
+module SearchApi
+  class Client
+    def initialize(config = SearchApi.configuration)
+      @config = config
+      @connection = build_connection
+    end
+
+    def get(path, params = {})
+      params[:api_key] = @config.api_key
+      response = @connection.get(path.delete_prefix("/"), params)
+      Response.new(response)
+    rescue Faraday::TooManyRequestsError => e
+      raise RateLimitError, e.message
+    rescue Faraday::UnauthorizedError => e
+      raise AuthenticationError, e.message
+    rescue Faraday::TimeoutError, Faraday::ConnectionFailed => e
+      raise SearchApi::TimeoutError, e.message
+    rescue Faraday::ResourceNotFound => e
+      raise NotFoundError, e.message
+    rescue Faraday::ServerError => e
+      raise SearchApi::ServerError, e.message
+    end
+
+    private
+
+    def build_connection
+      url = @config.base_url
+      url += "/" unless url.end_with?("/")
+      Faraday.new(url: url) do |f|
+        f.request :retry, max: @config.retries,
+                          retry_statuses: [429, 500, 502, 503]
+        f.request :json
+        f.response :json, content_type: /\bjson$/
+        f.response :raise_error
+        f.response :logger, @config.logger if @config.logger
+        f.options.timeout = @config.timeout
+      end
+    end
+  end
+end

data/lib/searchapi/configuration.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module SearchApi
+  class Configuration
+    attr_accessor :api_key, :base_url, :timeout, :retries, :logger
+
+    def initialize
+      @api_key  = ENV["SEARCHAPI_API_KEY"]
+      @base_url = "https://www.searchapi.io/api/v1"
+      @timeout  = 30
+      @retries  = 2
+      @logger   = nil
+    end
+  end
+end

data/lib/searchapi/error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module SearchApi
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class RateLimitError < Error; end
+  class TimeoutError < Error; end
+  class NotFoundError < Error; end
+  class ValidationError < Error; end
+  class ServerError < Error; end
+end

data/lib/searchapi/resource.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SearchApi
+  class Resource
+    def initialize(client = SearchApi.client)
+      @client = client
+    end
+
+    private
+
+    def get(params = {})
+      params[:engine] = engine_name
+      @client.get("/search", params)
+    end
+
+    def engine_name
+      raise NotImplementedError
+    end
+  end
+end

data/lib/searchapi/resources/airbnb.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class Airbnb < Resource
+      def search(query, check_in:, check_out:, **params)
+        get(q: query, check_in: check_in, check_out: check_out, **params)
+      end
+
+      private
+
+      def engine_name
+        "airbnb"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/amazon_search.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class AmazonSearch < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "amazon_search"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/apple_app_store.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class AppleAppStore < Resource
+      def search(term:, **params)
+        get(term: term, **params)
+      end
+
+      private
+
+      def engine_name
+        "apple_app_store"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/baidu.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class Baidu < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "baidu"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/bing.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class Bing < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "bing"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/bing_images.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class BingImages < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "bing_images"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/bing_videos.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class BingVideos < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "bing_videos"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/duckduckgo.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class DuckDuckGo < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "duckduckgo"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/ebay_search.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class EbaySearch < Resource
+      def search(query = nil, **params)
+        params[:q] = query if query
+        get(**params)
+      end
+
+      private
+
+      def engine_name
+        "ebay_search"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/facebook_business_page.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class FacebookBusinessPage < Resource
+      def search(**params)
+        get(**params)
+      end
+
+      def by_username(username, **params)
+        get(username: username, **params)
+      end
+
+      def by_page_id(page_id, **params)
+        get(page_id: page_id, **params)
+      end
+
+      private
+
+      def engine_name
+        "facebook_business_page"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class Google < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_about_this_domain.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleAboutThisDomain < Resource
+      def search(domain:, **params)
+        get(domain: domain, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_about_this_domain"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_ads_transparency_center.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleAdsTransparencyCenter < Resource
+      def search(**params)
+        get(**params)
+      end
+
+      def by_advertiser(advertiser_id, **params)
+        get(advertiser_id: advertiser_id, **params)
+      end
+
+      def by_domain(domain, **params)
+        get(domain: domain, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_ads_transparency_center"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_ai_mode.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleAiMode < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_ai_mode"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_ai_overview.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleAiOverview < Resource
+      def search(page_token:, **params)
+        get(page_token: page_token, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_ai_overview"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_autocomplete.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleAutocomplete < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_autocomplete"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_events.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleEvents < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_events"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_finance.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleFinance < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_finance"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_flights.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleFlights < Resource
+      def search(from:, to:, outbound_date:, return_date: nil, **params)
+        get(
+          departure_id: from,
+          arrival_id: to,
+          outbound_date: outbound_date,
+          return_date: return_date,
+          **params
+        )
+      end
+
+      private
+
+      def engine_name
+        "google_flights"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_forums.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleForums < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_forums"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_hotels.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleHotels < Resource
+      def search(query, check_in:, check_out:, **params)
+        get(q: query, check_in_date: check_in, check_out_date: check_out, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_hotels"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_images.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleImages < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_images"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_jobs.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleJobs < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_jobs"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_lens.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleLens < Resource
+      def search(url:, **params)
+        get(url: url, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_lens"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_local.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleLocal < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_local"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_maps.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleMaps < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      def place(data_id:, **params)
+        get(data_id: data_id, **params)
+      end
+
+      def directions(start:, destination:, **params)
+        @client.get("/search", {
+          engine: "google_maps_directions",
+          start_addr: start,
+          end_addr: destination,
+          **params
+        })
+      end
+
+      private
+
+      def engine_name
+        "google_maps"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_news.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleNews < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_news"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_patents.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GooglePatents < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_patents"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_play_store.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GooglePlayStore < Resource
+      def search(store:, **params)
+        get(store: store, **params)
+      end
+
+      def apps(query = nil, **params)
+        search(store: "apps", q: query, **params)
+      end
+
+      def games(query = nil, **params)
+        search(store: "games", q: query, **params)
+      end
+
+      def movies(query = nil, **params)
+        search(store: "movies", q: query, **params)
+      end
+
+      def books(query = nil, **params)
+        search(store: "books", q: query, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_play_store"
+      end
+    end
+  end
+end