Skip to content
This repository has been archived by the owner on Nov 30, 2018. It is now read-only.


Repository files navigation

Market Bot - Build Status Coverage Status

Market Bot is a web scraper (web robot, web spider) for the Google Play Android app store. It can collect data on apps, charts, and developers.

Google has recently changed the HTML and CSS for the Play Store. This has caused the release version of Market Bot to break. New code is in the master branch (unreleased) to begin fixing this problem. If you are interesed in helping then please join the discussion in issue 72.


  • Ruby MRI 2.1.X or newer
  • Nokogiri gem
  • Typhoeus gem


Add this line to your application's Gemfile to use the latest stable version:

gem 'market_bot'

And then execute:

$ bundle

App API example

# Download/parse the app.
app ='com.facebook.katana')

# Print out the app title.
puts app.title

# Print all the other attributes you can find on an app object.
puts MarketBot::Play::App::ATTRIBUTES.inspect

Charts API example

Charts are defined by a collection and an option category.

# Download/parse the chart (collection=topselling_free, category=GAME).
chart ='topselling_free', 'GAME')

# Print the first app.
puts chart.result.first.inspect

# Print all the chart collections & categories.
puts MarketBot::Play::Chart::COLLECTIONS.inspect
puts MarketBot::Play::Chart::CATEGORIES.inspect

Developer API example

# Download/parse developer.
dev ='Zynga')

# Print the first app.
puts dev.result.first.inspect

Language and Country support

Market Bot defaults to USA and English. You can specify a country and a language to override the defaults when creating objects:

chart ='topselling_paid', 'BUSINESS', country: 'jp', lang: 'ja')

app ='com.facebook.katana', country: 'jp', lang: 'ja')

Excessive Use

Google will block your IP address if you attempt to scrape large quantities of data.

Contributing to Market Bot

  1. Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  2. Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  3. Fork the project.
  4. Start a feature/bugfix branch.
  5. Commit and push until you are happy with your contribution.
  6. Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  7. Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.


Copyright (c) 2011 - 2018 Chad Remesch. See LICENSE.txt for further details.