App Store PPP pricing by country — free CLI that bulk-updates IAP & subscription prices in 175+ countries by purchasing power with AI agent skills support

• Easy to install — one line on macOS, Windows or Linux. No Python of your own required.
• Agent-friendly — Claude Code, Codex or Cursor can install it, configure it and run it for you.
• Safe by default — --dry-run prints all 174 prices before a single one is applied.
• Your API key never leaves your machine — no account, no upload, no server in the middle.
• 175+ territories in one command — in-app purchases and subscriptions alike.
• Real Apple price points — every price is one App Store Connect accepts, in the local currency.
• Free and open source (MIT) — no subscription needed to price your subscriptions.

appstore-ppp-prices is a free, open-source CLI that brings PPP pricing — purchasing power parity — to the App Store. It bulk-updates in-app purchase and subscription prices across 175+ countries, reading GDP-per-capita coefficients, optionally tuning them with GPT for your app type, and writing the prices straight through the App Store Connect API. One command instead of an afternoon of clicking through territories.

Other languages: Русский · Português · Español · 中文

Install It With Your AI Agent

Paste this into Claude Code, Codex, Cursor or any other coding agent. It installs the tool and walks you through the one-time App Store Connect setup:

Install the appstore-ppp-prices CLI for me: https://github.com/duceum/appstore-ppp-pricing-agent-skill
Run `uv tool install appstore-ppp-prices` (install uv first if it is missing), then help me create the
.env with my App Store Connect API key in the config directory the tool expects, install the agent skill
from the repo's agent-skills/ folder, and finish by verifying with `ppp-pricing --version`.

Rather do it by hand? It is two lines — macOS · Windows · Linux have the details:

uv tool install appstore-ppp-prices
ppp-pricing --app-id 123456789 --iap com.app.weekly --dry-run

Typical use cases: raising App Store revenue in emerging markets (India, Brazil, Indonesia), regional price localization for iOS games and subscription apps, bulk price changes without clicking through 175 territories by hand, and repricing driven by an AI agent such as Claude Code.

Why Apple's Automatic Pricing Leaves Money on the Table

When you set a US price, App Store Connect generates the other 174 storefronts for you — but it equalizes them. It converts your price at the current exchange rate and adjusts for local tax, so a subscriber in India pays roughly the same in dollars as one in Switzerland.

Exchange rates are not purchasing power. The median monthly wage differs by more than 20× across App Store territories, so a globally equalized price is simultaneously too high in emerging markets — where it suppresses conversion — and, in a few of the richest ones, lower than customers would happily pay.

PPP pricing sets each territory relative to what people there can actually afford.

What Your Prices Become

Real --dry-run output for a $5.99 weekly subscription with the default coefficients. Every price is an actual Apple price point in the country's own currency, next to what App Store Connect charges there by default:

Every country moved by exactly the coefficient it was given, in its own money — India pays ₹239 instead of ₹599, and Switzerland pays CHF 5.50 instead of CHF 5.00, because a Swiss customer can afford more than a globally equalized price assumes.

Why the prices are computed in local currency. The tool asks Apple what it charges in each territory for your US price, multiplies that by the country's coefficient, and picks a point from the territory's own price grid — which is fine-grained: Swiss francs move in 0.10 steps, Norwegian kroner in whole kroner. Where a target falls between two points it rounds away from the base price: up for a country priced above the US, down for one priced below.

Doing the same arithmetic in dollars — pick a USD price point and let Apple's equalization translate it — quietly distorts every row, because equalization only reaches a coarse subset of each grid. Every USD price from $6.39 to $6.99 becomes CHF 6.00, and both $5.99 and $6.59 become NOK 79. A +10% coefficient would arrive as +20% in Switzerland and as nothing at all in Norway.

What It Does

1. Connects to the App Store Connect API with your own .p8 key
2. Fetches your current in-app purchases, subscriptions and their US prices
3. Calculates a target price per country from GDP per capita
4. (Optional) Asks GPT to tune the coefficients for your app type — a puzzle game and an AI tool have very different price elasticity
5. Converts each target into a real local price point: Apple's own price for that territory, scaled by the coefficient
6. Applies everything in bulk, or prints a table and changes nothing with --dry-run

Built for AI Agents

Most regional-pricing tools are a web dashboard or a Mac app. This one is a single command with deterministic flags, which means an agent can drive it end to end:

• No GUI, no browser automation. Nothing to click, nothing to screenshot.
• --dry-run prints a readable table so the agent can check the numbers before anything is applied.
• No interactive prompts. Every decision is a flag.
• Plain-text errors and real exit codes, so a failed run is unambiguous.
• Runs in CI the same way it runs on a laptop.

In practice you can hand the whole task over:

"Preview PPP prices for my weekly subscription, then apply them everywhere except Russia and Belarus."

which is just these two commands:

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

Ready-made skills

Drop-in instructions for the main coding agents live in agent-skills/:

They teach the agent the two things --help cannot: that applying is irreversible and needs a confirmed --dry-run first, and that a subscription price change hits existing subscribers unless --preserved is passed. Install commands are in agent-skills/README.md.

Your API Key Never Leaves Your Machine

An App Store Connect key with pricing permissions can change what your customers are charged. Hosted pricing services need you to upload that key to their servers.

This tool runs locally. The .p8 file stays in your config directory, the JWT is signed on your machine, and requests go straight from your machine to Apple. There is no account to create, no server in the middle, and nothing to revoke afterwards but the key itself.

How It Compares

Requirements

• App Store Connect account with pricing permissions
• (Optional) OpenAI API key for AI analysis
• Python 3.10 or newer — not needed if you install with uv, which brings its own

Installation

Pick your operating system. Every path installs the same two commands: appstore-ppp-prices and the shorter ppp-pricing. The rest of this README uses the short one.

macOS

The easiest way is uv — it needs no Python of your own, it brings its own:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install appstore-ppp-prices
ppp-pricing --version

Prefer Homebrew?

brew tap duceum/tap
brew trust duceum/tap
brew install duceum/tap/appstore-ppp-prices

brew trust is Homebrew 6 asking whether you accept formula code from a third-party tap. Expect the install to take a few minutes: Homebrew builds Python dependencies from source, and three of them carry native extensions. uv uses prebuilt wheels and finishes in seconds.

Already have Python 3.10+? pipx install appstore-ppp-prices or pip install appstore-ppp-prices work too.

Your config will live in ~/.config/ppp-pricing/.

Windows

In PowerShell:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install appstore-ppp-prices

Close the terminal and open a new one so PATH is picked up, then check:

ppp-pricing --version

Already have Python 3.10+? pip install appstore-ppp-prices works too.

Your config will live in C:\Users\<you>\.config\ppp-pricing\ — create it with:

mkdir "$HOME\.config\ppp-pricing"

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install appstore-ppp-prices
ppp-pricing --version

pipx install appstore-ppp-prices and pip install --user appstore-ppp-prices work just as well if you already have Python 3.10+.

Your config will live in ~/.config/ppp-pricing/ (or $XDG_CONFIG_HOME/ppp-pricing/ if you set that variable).

Without installing anything

uvx appstore-ppp-prices --help

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

Setup

Step 1: 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!

Put the .p8 file in your config folder — macOS and Linux:

mkdir -p ~/.config/ppp-pricing
mv ~/Downloads/AuthKey_*.p8 ~/.config/ppp-pricing/

Windows (PowerShell):

mkdir "$HOME\.config\ppp-pricing"
Move-Item "$HOME\Downloads\AuthKey_*.p8" "$HOME\.config\ppp-pricing\"

Step 2: (Optional) Get an OpenAI API Key

AI analysis adjusts the coefficients for your specific app type. Without it, the tool uses the GDP-based defaults, which are perfectly usable.

1. Go to https://platform.openai.com/api-keys
2. Create a key and copy it (starts with sk-)

LLM_BASE_URL=https://openrouter.ai/api/v1
LLM_MODEL=meta-llama/llama-3.3-70b-instruct

Step 3: Create the .env Config File

Create a .env file next to the key — note the dot at the beginning of the file name:

nano ~/.config/ppp-pricing/.env

On Windows: notepad "$HOME\.config\ppp-pricing\.env"

Fill in your values:

ASC_KEY_ID=your_key_id
ASC_ISSUER_ID=your_issuer_id
ASC_PRIVATE_KEY_PATH=AuthKey_XXXX.p8
LLM_API_KEY=sk-your-key
LLM_MODEL=gpt-5.2

ASC_PRIVATE_KEY_PATH is the name of the downloaded .p8 file — a bare name is resolved next to the .env.

Prefer to keep the config elsewhere? Point at it with --config /path/to/dir, set PPP_PRICING_CONFIG, or just run the tool from a directory that has a .env in it.

Step 4: 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

Raise prices for new subscribers only, starting next month:

ppp-pricing --app-id 123456789 --iap com.app.weekly --preserved --start-date 2026-09-01

Clear cached AI analysis results:

ppp-pricing --clear-cache

Country Categories

Countries are divided into 6 categories by GDP per capita:

AI analysis moves these up or down for your app type; --coeff overrides them outright. The full list of 175+ countries with their GDP per capita and default coefficients lives in appstore_ppp_prices/countries.csv — edit it if you disagree with a placement.

FAQ

Does this change prices for existing subscribers? By default, yes — a price change applies to everyone. Pass --preserved to grandfather current subscribers at their existing price and apply the new one only to new sign-ups. Subscriptions only; one-time in-app purchases have no such concept.

Can I see what will happen before anything changes? That is what --dry-run is for. It prints the full table of 174 target prices and writes nothing.

Does it handle both in-app purchases and subscriptions? Both. They use different App Store Connect endpoints, and the tool picks the right one automatically.

Where does my App Store Connect API key go? Nowhere. It stays in your config directory, the JWT is signed locally, and requests go straight to Apple.

How are the coefficients calculated? Each country is placed in one of six income tiers by GDP per capita, and each tier has a default multiplier relative to the US price. With an OpenAI key, GPT adjusts those multipliers for your app's category and price elasticity — a casual game tolerates much deeper discounts than an AI tool with per-request server costs. Minimum coefficient is 0.35, and price floors of $0.99 / $0.49 are enforced with ratios between your products preserved.

What happens if my target price is between two Apple price points? It rounds in the direction of the change, in the local currency: up when the country is priced above the US, down when it is below. Exact matches are used as-is.

Can I run it from CI or from an AI agent? Yes. No interactive prompts, deterministic flags, real exit codes. See Built for AI Agents.

Does it support Google Play? Not today. This tool is App Store only.

Can I schedule a price change? Yes, for subscriptions: --start-date YYYY-MM-DD. The default is two days out.

What if I disagree with a country's tier? Override a whole category with --coeff emerging=0.50, exclude countries with --exclude, or edit countries.csv directly.

Troubleshooting

Running Tests

pip install pytest
pytest

Who Made This

I'm Aleksandr Belousov, an indie iOS developer. I built this tool to reprice my own apps across 175 territories without spending an afternoon in App Store Connect, and open-sourced it because every indie hits the same wall.

Website: belousov.one · X/Twitter: @duceum · GitHub: @duceum

Found a bug or disagree with a country's tier? Open an issue.

License

MIT — see LICENSE.