https://github.com/garno/peekapp
Retrieve ratings & reviews from the App Store.
https://github.com/garno/peekapp
Last synced: about 1 year ago
JSON representation
Retrieve ratings & reviews from the App Store.
- Host: GitHub
- URL: https://github.com/garno/peekapp
- Owner: garno
- Created: 2011-02-13T02:50:35.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2013-07-16T14:56:00.000Z (almost 13 years ago)
- Last Synced: 2025-04-18T03:24:29.994Z (about 1 year ago)
- Language: Ruby
- Homepage:
- Size: 66.4 KB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.markdown
Awesome Lists containing this project
README
Retrieve reviews and ratings from the App Store.
# Installation
gem install peekapp
## How to
For advanced functionnalities you should read the source. Peekapp can only retrieve ratings & reviews from the Canadian App Store.
require "peekapp"
# Get the App
app = Peekapp::Apps::find 390574988 # App ID
# Get reviews for this App
app.reviews
# => [# "Amazing",
# :comment => "Best Twitter app on the face of the planet!",
# :username => "Thomas Gallagher",
# :rating => 5,
# :user_id => 33308895,
# :version => "2.0",
# :date => "9-Oct-2009",
# :id => Digest::SHA256.new("title + username")
# }>, ...]
# And the ratings...
app.ratings
# => [#Rating:0x1029372a23 @data={
# :current => { "1": 38, "2": 12, "3": 23, "4": 25, "5": 105 },
# :all => { "1": 2736, "2": 749, "3": 1045, "4": 1103, "5": 3880 },
# :store_id => "143455-5,12"
# }>, ...]
## Warning
Since Peekapp is **scraping** the App Store, you might experience some problems if Apple change iTunes' html layout. I've made some tests and the App Store is updated every 20 minutes (*ballpark*). So don't waste your time trying to get *real time* ratings & reviews.
## Todo
- Create unit tests w/ [FakeWeb](https://github.com/chrisk/fakeweb)
- Allow international App Stores
- iTunes Connect support