Grow App Store Revenue with Regional Pricing — Automatic PPP Price Localization for 175+ Countries

appstore-ppp-prices localizes App Store in-app purchase and subscription prices across 175+ countries by purchasing power parity (PPP): GDP-per-capita coefficients, optional AI tuning for your app type, and price tiers applied directly through the App Store Connect API — one command instead of hours in the App Store Connect UI.

Документация на русском (README.ru.md)

Typical use cases: raising App Store revenue in emerging markets (India, Brazil, Indonesia), price localization for iOS games and subscription apps, bulk price changes without clicking through 175 territories by hand.

What It Does

1. Connects to the App Store Connect API
2. Fetches current product prices (IAP or subscription)
3. Calculates optimal prices per country based on purchasing power
4. (Optional) Uses GPT to fine-tune coefficients for your app type
5. Applies calculated prices via the API

Requirements

• Python 3.10 or newer
• App Store Connect account with pricing permissions
• (Optional) OpenAI API key for AI analysis

Step-by-Step Setup

Step 1: Install Python

If Python is not installed yet:

• macOS: open Terminal and run:

  brew install python
  

  No Homebrew? Download Python from https://www.python.org/downloads/

• Windows: download the installer from https://www.python.org/downloads/ and check "Add Python to PATH" during installation

Verify:

python3 --version

Should show Python 3.10 or higher.

Step 2: Download the Project

Open a terminal and run:

git clone https://github.com/duceum/appstore-ppp-pricing-agent-skill.git
cd appstore-ppp-pricing-agent-skill

No git installed? Get it with brew install git (macOS) or from https://git-scm.com/downloads (Windows).

Prefer not to use git? Download the ZIP instead: https://github.com/duceum/appstore-ppp-pricing-agent-skill/archive/refs/heads/main.zip — unzip it, then cd into the unzipped folder.

Step 3: Install Dependencies

pip install -e .

This installs all required libraries automatically.

Step 4: Create an App Store Connect API Key

1. Go to https://appstoreconnect.apple.com/access/integrations/api
2. Click "Generate API Key"
3. Name: anything (e.g. ppp-pricing)
4. Access: Admin or App Manager
5. Click "Generate"
6. Copy the Key ID (10 characters, e.g. A1B2C3D4E5)
7. Copy the Issuer ID (UUID shown at the top of the page)
8. Download the .p8 file — this is your private key. You can only download it once!

Place the .p8 file in the project folder.

Step 5: (Optional) Get an OpenAI API Key

If you want AI-driven coefficient analysis for better pricing:

1. Go to https://platform.openai.com/api-keys
2. Click "Create new secret key"
3. Copy the key (starts with sk-...)

Step 6: Create the .env Config File

Create a .env file in the project folder (note the dot at the beginning).

You can copy the template:

cp .env.example .env

Open .env in any text editor and fill in your values:

ASC_KEY_ID=your_key_id
ASC_ISSUER_ID=your_issuer_id
ASC_PRIVATE_KEY_PATH=AuthKey_XXXX.p8
OPENAI_API_KEY=sk-your-key

Replace with your actual values. ASC_PRIVATE_KEY_PATH is the name of the downloaded .p8 file.

Step 7: Verify the Installation

Run the command with your App ID (9-digit number from App Store Connect):

ppp-pricing --app-id 123456789

If everything is configured correctly, you'll see a list of all IAPs and subscriptions for your app.

Usage

List all products

ppp-pricing --app-id 123456789

Preview prices (without applying)

ppp-pricing --app-id 123456789 --iap com.app.weekly --dry-run

Shows a table of calculated prices per country. Nothing changes in App Store.

Apply prices

ppp-pricing --app-id 123456789 --iap com.app.weekly

Warning: this command will actually change prices in App Store Connect!

Options

Examples

Preview prices with AI analysis:

ppp-pricing --app-id 123456789 --iap com.app.weekly --dry-run

Preview prices without AI:

ppp-pricing --app-id 123456789 --iap com.app.weekly --dry-run --no-ai

Apply prices, excluding Russia and Belarus:

ppp-pricing --app-id 123456789 --iap com.app.weekly --exclude RUS,BLR

Override the coefficient for emerging markets:

ppp-pricing --app-id 123456789 --iap com.app.weekly --coeff emerging=0.50 --dry-run

Clear cached AI analysis results:

ppp-pricing --clear-cache

Country Categories

Countries are divided into 6 categories by GDP per capita:

Troubleshooting

Running Tests

pip install pytest
pytest