searchapi-ruby 0.1.0

data/lib/searchapi/resources/google_rank_tracking.rb

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

data/lib/searchapi/resources/google_scholar.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleScholar < Resource
+      def search(query, **params)
+        get(q: query, **params)
+      end
+
+      def cite(article_id, **params)
+        get(cites: article_id, **params)
+      end
+
+      private
+
+      def engine_name
+        "google_scholar"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_shopping.rb

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

data/lib/searchapi/resources/google_shorts.rb

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

data/lib/searchapi/resources/google_trends.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module SearchApi
+  module Resources
+    class GoogleTrends < Resource
+      def search(query, data_type:, **params)
+        get(q: query, data_type: data_type, **params)
+      end
+
+      def interest_over_time(query, **params)
+        search(query, data_type: "TIMESERIES", **params)
+      end
+
+      def interest_by_region(query, **params)
+        search(query, data_type: "GEO_MAP", **params)
+      end
+
+      def related_queries(query, **params)
+        search(query, data_type: "RELATED_QUERIES", **params)
+      end
+
+      def related_topics(query, **params)
+        search(query, data_type: "RELATED_TOPICS", **params)
+      end
+
+      private
+
+      def engine_name
+        "google_trends"
+      end
+    end
+  end
+end

data/lib/searchapi/resources/google_videos.rb

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

data/lib/searchapi/resources/instagram_profile.rb

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

data/lib/searchapi/resources/linkedin_ad_library.rb

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

data/lib/searchapi/resources/meta_ad_library.rb

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

data/lib/searchapi/resources/naver.rb

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

data/lib/searchapi/resources/reddit_ad_library.rb

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

data/lib/searchapi/resources/shein_search.rb

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

data/lib/searchapi/resources/tiktok_ads_library.rb

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

data/lib/searchapi/resources/tiktok_profile.rb

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

data/lib/searchapi/resources/tripadvisor.rb

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

data/lib/searchapi/resources/walmart_search.rb

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

data/lib/searchapi/resources/yahoo.rb

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

data/lib/searchapi/resources/yandex.rb

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

data/lib/searchapi/resources/yandex_reverse_image.rb

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

data/lib/searchapi/resources/youtube.rb

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

data/lib/searchapi/response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module SearchApi
+  class Response
+    attr_reader :data, :status, :headers
+
+    def initialize(faraday_response)
+      @data    = faraday_response.body
+      @status  = faraday_response.status
+      @headers = faraday_response.headers
+    end
+
+    def success?
+      status == 200
+    end
+
+    def results
+      data.is_a?(Hash) ? data : {}
+    end
+
+    def credits_remaining
+      headers["x-remaining-credits"]&.to_i
+    end
+  end
+end

data/lib/searchapi/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SearchApi
+  VERSION = "0.1.0"
+end

data/lib/searchapi.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+require_relative "searchapi/version"
+require_relative "searchapi/configuration"
+require_relative "searchapi/error"
+require_relative "searchapi/response"
+require_relative "searchapi/client"
+require_relative "searchapi/resource"
+
+# Google engines
+require_relative "searchapi/resources/google"
+require_relative "searchapi/resources/google_rank_tracking"
+require_relative "searchapi/resources/google_events"
+require_relative "searchapi/resources/google_maps"
+require_relative "searchapi/resources/google_scholar"
+require_relative "searchapi/resources/google_news"
+require_relative "searchapi/resources/google_jobs"
+require_relative "searchapi/resources/google_shopping"
+require_relative "searchapi/resources/google_flights"
+require_relative "searchapi/resources/google_images"
+require_relative "searchapi/resources/google_videos"
+require_relative "searchapi/resources/google_trends"
+require_relative "searchapi/resources/google_autocomplete"
+require_relative "searchapi/resources/google_finance"
+require_relative "searchapi/resources/google_hotels"
+require_relative "searchapi/resources/google_about_this_domain"
+require_relative "searchapi/resources/google_ai_mode"
+require_relative "searchapi/resources/google_ads_transparency_center"
+require_relative "searchapi/resources/google_local"
+require_relative "searchapi/resources/google_shorts"
+require_relative "searchapi/resources/google_lens"
+require_relative "searchapi/resources/google_forums"
+require_relative "searchapi/resources/google_patents"
+require_relative "searchapi/resources/google_ai_overview"
+require_relative "searchapi/resources/google_play_store"
+
+# Other search engines
+require_relative "searchapi/resources/amazon_search"
+require_relative "searchapi/resources/bing"
+require_relative "searchapi/resources/bing_images"
+require_relative "searchapi/resources/bing_videos"
+require_relative "searchapi/resources/baidu"
+require_relative "searchapi/resources/yandex"
+require_relative "searchapi/resources/yandex_reverse_image"
+require_relative "searchapi/resources/duckduckgo"
+require_relative "searchapi/resources/yahoo"
+require_relative "searchapi/resources/naver"
+require_relative "searchapi/resources/youtube"
+
+# App stores
+require_relative "searchapi/resources/apple_app_store"
+
+# E-commerce
+require_relative "searchapi/resources/walmart_search"
+require_relative "searchapi/resources/shein_search"
+require_relative "searchapi/resources/ebay_search"
+
+# Travel & hospitality
+require_relative "searchapi/resources/airbnb"
+require_relative "searchapi/resources/tripadvisor"
+
+# Social media profiles
+require_relative "searchapi/resources/instagram_profile"
+require_relative "searchapi/resources/tiktok_profile"
+require_relative "searchapi/resources/facebook_business_page"
+
+# Ad libraries
+require_relative "searchapi/resources/linkedin_ad_library"
+require_relative "searchapi/resources/reddit_ad_library"
+require_relative "searchapi/resources/meta_ad_library"
+require_relative "searchapi/resources/tiktok_ads_library"
+
+module SearchApi
+  # Registry mapping accessor names to resource classes.
+  RESOURCES = {
+    # Google engines
+    google: Resources::Google,
+    google_rank_tracking: Resources::GoogleRankTracking,
+    google_events: Resources::GoogleEvents,
+    google_maps: Resources::GoogleMaps,
+    google_scholar: Resources::GoogleScholar,
+    google_news: Resources::GoogleNews,
+    google_jobs: Resources::GoogleJobs,
+    google_shopping: Resources::GoogleShopping,
+    google_flights: Resources::GoogleFlights,
+    google_images: Resources::GoogleImages,
+    google_videos: Resources::GoogleVideos,
+    google_trends: Resources::GoogleTrends,
+    google_autocomplete: Resources::GoogleAutocomplete,
+    google_finance: Resources::GoogleFinance,
+    google_hotels: Resources::GoogleHotels,
+    google_about_this_domain: Resources::GoogleAboutThisDomain,
+    google_ai_mode: Resources::GoogleAiMode,
+    google_ads_transparency_center: Resources::GoogleAdsTransparencyCenter,
+    google_local: Resources::GoogleLocal,
+    google_shorts: Resources::GoogleShorts,
+    google_lens: Resources::GoogleLens,
+    google_forums: Resources::GoogleForums,
+    google_patents: Resources::GooglePatents,
+    google_ai_overview: Resources::GoogleAiOverview,
+    google_play_store: Resources::GooglePlayStore,
+
+    # Other search engines
+    amazon_search: Resources::AmazonSearch,
+    bing: Resources::Bing,
+    bing_images: Resources::BingImages,
+    bing_videos: Resources::BingVideos,
+    baidu: Resources::Baidu,
+    yandex: Resources::Yandex,
+    yandex_reverse_image: Resources::YandexReverseImage,
+    duckduckgo: Resources::DuckDuckGo,
+    yahoo: Resources::Yahoo,
+    naver: Resources::Naver,
+    youtube: Resources::YouTube,
+
+    # App stores
+    apple_app_store: Resources::AppleAppStore,
+
+    # E-commerce
+    walmart_search: Resources::WalmartSearch,
+    shein_search: Resources::SheinSearch,
+    ebay_search: Resources::EbaySearch,
+
+    # Travel & hospitality
+    airbnb: Resources::Airbnb,
+    tripadvisor: Resources::TripAdvisor,
+
+    # Social media profiles
+    instagram_profile: Resources::InstagramProfile,
+    tiktok_profile: Resources::TiktokProfile,
+    facebook_business_page: Resources::FacebookBusinessPage,
+
+    # Ad libraries
+    linkedin_ad_library: Resources::LinkedinAdLibrary,
+    reddit_ad_library: Resources::RedditAdLibrary,
+    meta_ad_library: Resources::MetaAdLibrary,
+    tiktok_ads_library: Resources::TiktokAdsLibrary
+  }.freeze
+
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def client
+      @client ||= Client.new(configuration)
+    end
+
+    def reset!
+      @configuration = nil
+      @client = nil
+      @resources = nil
+    end
+
+    def resources
+      @resources ||= {}
+    end
+
+    def method_missing(name, *args, &block)
+      if RESOURCES.key?(name)
+        resources[name] ||= RESOURCES[name].new(client)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      RESOURCES.key?(name) || super
+    end
+  end
+end