Ralexa

Ruby client for Amazon Alexa APIs.

These include Alexa Top Sites and Alexa Web Information Service.

HTTP transport thanks to Net::HTTP, with a little help from addressable.

XML parsing courtesy of Nokogiri.

Thorough test coverage provided by MiniTest::Spec.

Deprecation Notice

AWS introduced IAM credentials support for accessing AWIS and Alexa Top Sites. They deprecated the use of root account credentials and will stop working on January 31, 2018.

This gem doesn't support using IAM credentials and we're no longer maintaining this gem.

If you're up for the challenge and very keen to keep this up to date, we're looking for someone willing to maintain.

Installation

# with bundler
echo 'gem "ralexa"' >> Gemfile
bundle

# or just the gem
gem install ralexa

Usage Examples

# grab a Ralexa::Session instance to hold your credentials.
session = Ralexa.session("aws_access_key_id", "aws_secret_access_key")

# all countries
countries = session.top_sites.list_countries
p countries.map(&:name)

# global top 250 sites
global = session.top_sites.global(250)

# per-country top sites
first_by_country = {}
countries.each do |c|
  first_by_country[c.name] = session.top_sites.country(c.code, 1).first.url
end

# individual country lookup
puts "Top Ten Australian Sites"
session.top_sites.country("AU", 10).each do |s|
  puts "#{s.url} (#{s.page_views} pageviews)"
end

# url info for an individual site
puts "Url info of Flippa.com"
puts session.url_info.get("http://flippa.com")

puts "bam!"

Status

Contributing

1. Fork it
2. Create your feature branch (git checkout -b some-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin some-new-feature)
5. Create new Pull Request

License

(c) 2012 Flippa, The MIT License.