Build Status Dependency Status


Get details about any app in the Apple App Store. This gem uses iTunes lookup method to get information about apps. (i.e.

Compatible with ruby >= 1.9.3


Add this line to your application's Gemfile:

gem 'app_store_info'

And then execute:

$ bundle

Or install it yourself as:

$ gem install appstore_info


You first have to read the app details, using the store URL or directly with the ID:

app = AppStoreInfo.read_url('')
app =
app =, 'gb') # You can give a particular region or it will use 'us'

Then you have some attributes that can be read easily:                  # => 343200656                # => "Angry Birds"
app.url                 # => ""
app.average_user_rating # => 4.5
app.user_rating_count   # => 222131
app.genre_ids           # => ["6014", "7003", "6016", "7001"]
app.price               # => 0.79
app.currency            # => "GBP"
app.supported_devices   # => ["iPhone-3GS", "iPhone4", "iPodTouchFourthGen", ...]             # => "Rovio Entertainment Ltd"
app.description         # => "Use the unique powers of the Angry Birds to destroy ...
app.minimum_os_version  # => "6.0"
app.features            # => ["gameCenter"]

You can also check if the app is Universal:

app.universal? # => false

Last, you can check the details about the latest version of the app:

current_version = app.current_version

current_version.average_user_rating # => 4.0
current_version.user_rating_count   # => 191
current_version.number              # => "5.2.0"
current_version.release_notes       # => "We popped some pesky bugs!"

If you need to get the genre names there's an helper method for that:

app.genre_names # => ["Games", "Action", "Arcade", "Entertainment"]

Keep in mind that the information can be localized if you request for a particular region information. Ratings, currency, price etc. can change.


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec 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 tags, and push the .gem file to


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.