0.0
No release in over 3 years
Low commit activity in last 3 years
SearchData is a REST API that collects any kind of data from search engines and transforms it into a complete data toolkit for every team in your company. This SDK for Ruby makes the usage of the API easier to implement in any project you have.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 3.2

Runtime

~> 2.7.6
~> 2.5.1
~> 0.1.0
 Project Readme

SearchData Ruby SDK

SearchData is an API that allows scraping various search engines such as Google, Bing, Yandex, etc. while using rotating proxies to prevent bans. This SDK for Ruby makes the usage of the API easier to implement in any project you have.

Installation

You must have modern Ruby already installed.

Add this line to your application's Gemfile:

gem 'searchdata_sdk'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install searchdata_sdk

API Key

To use the API and the SDK you will need an API Key. You can get one by registering at SearchData.

Usage

Use the following code to get started with the SDK:

require "searchdata_sdk"

params = {
  api_key: "{API_KEY}", # copy the API_KEY from your Dashboard
  engine: "google",
  q: "coffee"
}

client = GoogleSearch.new(params)
result = client.get_json

pp result
puts "Google demo passed."
exit 0

Alternatively, check the examples folder for more code samples, including Yandex and Bing classes.

For a better understanding of the parameters, please check out our documentation.

Development

After checking out the repo, run bin/setup or bundle install to install dependencies.

Then, run rake spec or bundle exec rake to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/SearchDataAPI/ruby-sdk.