No commit activity in last 3 years
No release in over 3 years
A simple module that holds currencies and prices from the Apple's iOS App Store.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
 Project Readme

App Store Pricing Matrix

Build Status

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,

  1. Login to iTunes Connect with your developer account.
  2. Run rake aspm:open and enter any App Store ID that you own.
  3. Your default browser will launch and load the JSON. Copy the entire content and paste into input/pricing_matrix.json.
  4. Run rake to check if anything is broken.
  5. 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 and REVERSE_CURRENCY_MAP are removed. They are all self-referential now.
  • CUSTOMER_CURRENCIES and DEVELOPER_CURRENCIES are removed. Use CURRENCIES instead.