App Store Pricing Matrix
A simple module that holds currencies and prices from the Apple's iOS App Store.
Install
gem install app_store_pricing_matrix
Usage
price = AppStorePricingMatrix.find_by(tier: 1, country: 'US')
price.country # => "United States"
price.country_code # => "US"
price.currency_symbol # => "$"
price.currency_code # => "USD"
price.wholesale_price # => 0.7
price.retail_price # => 0.99
price.formatted_retail_price # => "$0.99"
price.formatted_wholesale_price # => "$0.70"
AppStorePricingMatrix.stems
# => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 510, 530, 550, 560, 570, 580, 590]
AppStorePricingMatrix.countries
# => ["US", "CA", "MX", "AU", "NZ", "JP", "CN", "SG", "HK", "TW", "ID", "IN", "RU", "TR", "IL", "ZA", "SA", "AE", "GB", "DK", "SE", "CH", "NO", "LU", "MT", "CY", "DE", "FR", "AT", "BG", "EE", "SK", "BE", "CZ", "LV", "LT", "NL", "ES", "IT", "SI", "GR", "IE", "PL", "PT", "FI", "RO", "HU", "KR"]
AppStorePricingMatrix.currencies
# => ["USD", "CAD", "MXN", "AUD", "NZD", "JPY", "CNY", "SGD", "HKD", "TWD", "IDR", "INR", "RUB", "TRY", "ILS", "ZAR", "SAR", "AED", "GBP", "DKK", "SEK", "CHF", "NOK", "EUR"]
Updating the price
The pricing matrix JSON is taken from Apple's hidden API at the following URL.
https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/apps/#{AppStoreID}/pricing/matrix
The URL is accessible when you are logged in to iTunes Connect with your browser.
When you need to update the pricing matrix,
- Login to iTunes Connect with your developer account.
- Run
rake aspm:open
and enter any App Store ID that you own. - Your default browser will launch and load the JSON. Copy the entire content and paste into
input/pricing_matrix.json
. - Run
rake
to check if anything is broken. - Send a pull request with updated
input/pricing_matrix.json
.
Changelog
v3.0.0 (May 2, 2016)
- Complete overhaul. Now we use the JSON data fetched from Apple's hidden API.
v2.1.0 (October 26, 2012)
- Based on v14.
- Added RUB, TRY, INR, IDR, ILS, ZAR, SAR and AED
v2.0.0 (July 18, 2012)
- Based on v13.
- Added SGD, HKD and TWD.
-
CURRENCY_MAP
andREVERSE_CURRENCY_MAP
are removed. They are all self-referential now. -
CUSTOMER_CURRENCIES
andDEVELOPER_CURRENCIES
are removed. UseCURRENCIES
instead.