app-store-price-index

Price localization intelligence for iOS/macOS apps using purchasing power parity analysis. Use this skill when working with App Store pricing for any of these tasks: (1) Building a "Price Index" by analyzing reference app prices across territories, (2) Comparing your app's pricing against PPP-adjusted benchmarks, (3) Generating localized price recommendations based on economic data, (4) Automating price updates via App Store Connect API, (5) Analyzing competitor pricing strategies across markets, (6) Identifying overpriced/underpriced territories hurting conversions or revenue, (7) Creating pricing health reports with actionable recommendations.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "app-store-price-index" with this command: npx skills add onatcipli/skills/onatcipli-skills-app-store-price-index

App Store Price Index

Optimize your App Store pricing using purchasing power parity analysis—like the Big Mac Index or Spotify Premium Index, but for your iOS/macOS apps.

Concept

Different countries have vastly different purchasing power. A $9.99/month subscription that feels reasonable in the US may be unaffordable in India or Turkey. This skill helps you set data-driven, localized prices that maximize both conversions and revenue.

The Premium Index Approach

  1. Collect reference prices — Fetch prices of popular apps (Spotify, Netflix, etc.) across all 175 App Store territories
  2. Calculate index — Compare each territory's price to the US baseline
  3. Cross-reference PPP — Validate against World Bank purchasing power parity data
  4. Generate recommendations — Suggest optimal prices per territory
  5. Automate updates — Apply prices via App Store Connect API

API Access Tiers

TierAuthScopeUse Case
PublicNoneAny app's price via iTunes LookupBuild Premium Index, competitor analysis
PrivateJWTYour apps' price points + write accessGet equalizations, apply price changes

Workflow 1 — Build Premium Index

Create a price index by analyzing reference apps across territories.

Step 1: Select Reference Apps

Choose 3-5 popular subscription apps as benchmarks:

Suggested references by category:
- General: Spotify (id: 324684580), Netflix (id: 363590051)
- Productivity: Notion (id: 1232780281), Todoist (id: 585829637)
- Fitness: Strava (id: 426826309), MyFitnessPal (id: 341232718)
- News: NYTimes (id: 284862083), The Athletic (id: 1135216317)

Step 2: Fetch Prices Across Territories

For each reference app, fetch prices from all territories:

GET https://itunes.apple.com/lookup?id={app_id}&country={territory_code}

Response fields:

  • price — Numeric price value
  • currency — Currency code (USD, EUR, GBP, etc.)
  • formattedPrice — Localized string ("$9.99", "€9,99", "Free")

Rate limiting: ~20 requests/minute. Cache results aggressively.

Step 3: Calculate Index Values

For each territory, calculate:

price_index = local_price_in_usd / us_price

Where local_price_in_usd = local_price × exchange_rate_to_usd

Step 4: Generate Index Table

Output format:

| Territory | Currency | Spotify | Netflix | Avg Index | PPP Factor | Status |
|-----------|----------|---------|---------|-----------|------------|--------|
| USA       | USD      | $11.99  | $15.49  | 1.00      | 1.00       | Baseline |
| GBR       | GBP      | £11.99  | £10.99  | 0.92      | 0.69       | High |
| IND       | INR      | ₹119    | ₹199    | 0.14      | 0.28       | Optimized |
| TUR       | TRY      | ₺57.99  | ₺63.99  | 0.16      | 0.19       | Good |
| BRA       | BRL      | R$21.90 | R$39.90 | 0.35      | 0.41       | Low |

Status interpretation:

  • Baseline — Reference territory (usually USA)
  • Optimized — Index aligns well with PPP (within ±20%)
  • High — Price higher than PPP suggests (may hurt conversions)
  • Low — Price lower than PPP suggests (leaving money on table)
  • Good — Reasonable alignment

See index-methodology.md for calculation details.


Workflow 2 — Analyze Your Current Pricing

Compare your app's pricing against the Premium Index to identify optimization opportunities.

Step 1: Fetch Your Current Prices

Option A: Via iTunes Lookup (public)

GET https://itunes.apple.com/lookup?id={your_app_id}&country={territory}

Option B: Via App Store Connect API (private, more accurate)

GET /v1/apps/{id}/appPriceSchedule
GET /v1/subscriptions/{id}/pricePoints?filter[territory]={territory}

Step 2: Compare Against Index

For each territory:

your_index = your_price_in_usd / your_us_price
deviation = (your_index - premium_index) / premium_index × 100

Step 3: Generate Pricing Health Report

## Pricing Health Report — {App Name}

### Summary
- Territories analyzed: 175
- Optimized: 42 (24%)
- Potentially overpriced: 58 (33%)
- Potentially underpriced: 75 (43%)

### Top Opportunities

#### Overpriced (may hurt conversions)
| Territory | Your Price | Recommended | Potential Impact |
|-----------|------------|-------------|------------------|
| Brazil    | $9.99      | $4.99       | +45% conversions |
| India     | $6.99      | $2.99       | +120% conversions |
| Turkey    | $7.99      | $1.99       | +85% conversions |

#### Underpriced (leaving revenue on table)
| Territory | Your Price | Recommended | Potential Impact |
|-----------|------------|-------------|------------------|
| Switzerland | $9.99    | $14.99      | +50% revenue |
| Norway      | $9.99    | $12.99      | +30% revenue |
| UAE         | $9.99    | $11.99      | +20% revenue |

Workflow 3 — Generate Localized Price Recommendations

Create a complete price schedule optimized for each territory.

Input Required

  1. Base price — Your price in a reference territory (usually USA)
  2. Product type — App, subscription, or in-app purchase
  3. Strategy — Conservative, balanced, or aggressive localization

Strategy Options

StrategyDescriptionIndex Multiplier
ConservativeMinimal variation, prioritize simplicity0.3× PPP adjustment
BalancedModerate localization (recommended)0.6× PPP adjustment
AggressiveFull PPP alignment, maximize reach1.0× PPP adjustment

Step 1: Calculate Target Prices

for territory in territories:
    ppp_factor = get_ppp_factor(territory)
    strategy_weight = get_strategy_weight(strategy)

    # Calculate adjustment
    adjustment = (1 - ppp_factor) * strategy_weight
    target_price = base_price * (1 - adjustment)

    # Ensure minimum viable price
    target_price = max(target_price, minimum_prices[territory])

Step 2: Match to Apple Price Points

Apple has ~800 fixed price points. Match each target to the nearest available tier:

GET /v1/subscriptionPricePoints/{base_point_id}/equalizations

This returns equivalent price points across all territories.

Step 3: Output Price Schedule

## Recommended Price Schedule — {App Name}

Base: $9.99 USD (Monthly Subscription)
Strategy: Balanced

| Territory | Currency | Current | Recommended | Price Point ID | Change |
|-----------|----------|---------|-------------|----------------|--------|
| USA       | USD      | $9.99   | $9.99       | pp_usa_999     | —      |
| GBR       | GBP      | £9.99   | £7.99       | pp_gbr_799     | -20%   |
| EUR       | EUR      | €10.99  | €8.99       | pp_eur_899     | -18%   |
| IND       | INR      | ₹799    | ₹299        | pp_ind_299     | -63%   |
| BRA       | BRL      | R$54.90 | R$34.90     | pp_bra_3490    | -36%   |
| JPN       | JPY      | ¥1,500  | ¥1,200      | pp_jpn_1200    | -20%   |

Workflow 4 — Apply Pricing via API

Automate price updates using App Store Connect API.

Prerequisites

  • App Store Connect API key with appropriate permissions
  • JWT token generation capability
  • See apple-pricing-api.md for auth setup

For Subscriptions

POST /v1/subscriptionPrices
{
  "data": {
    "type": "subscriptionPrices",
    "attributes": {
      "startDate": "2024-02-01"  // Optional: schedule future change
    },
    "relationships": {
      "subscription": {
        "data": { "type": "subscriptions", "id": "{subscription_id}" }
      },
      "subscriptionPricePoint": {
        "data": { "type": "subscriptionPricePoints", "id": "{price_point_id}" }
      }
    }
  }
}

Repeat for each territory.

For In-App Purchases

POST /v1/inAppPurchasePriceSchedules
{
  "data": {
    "type": "inAppPurchasePriceSchedules",
    "relationships": {
      "inAppPurchase": {
        "data": { "type": "inAppPurchases", "id": "{iap_id}" }
      },
      "manualPrices": {
        "data": [
          { "type": "inAppPurchasePrices", "id": "${placeholder-0}" },
          { "type": "inAppPurchasePrices", "id": "${placeholder-1}" }
        ]
      },
      "baseTerritory": {
        "data": { "type": "territories", "id": "USA" }
      }
    }
  },
  "included": [
    {
      "type": "inAppPurchasePrices",
      "id": "${placeholder-0}",
      "relationships": {
        "inAppPurchasePricePoint": {
          "data": { "type": "inAppPurchasePricePoints", "id": "{point_id}" }
        }
      }
    }
  ]
}

Safety Checks

Before applying prices:

  1. Preview changes — Show before/after comparison
  2. Require confirmation — User must explicitly approve
  3. Validate price points — Ensure all IDs are valid
  4. Check for scheduled changes — Avoid conflicts with pending updates

Workflow 5 — Competitor Price Intelligence

Analyze how competitors price across territories.

Step 1: Identify Competitors

GET https://itunes.apple.com/search?term={category}&media=software&limit=50

Or user provides specific app IDs.

Step 2: Fetch Competitor Prices

For each competitor, fetch prices across key territories:

key_territories = ['USA', 'GBR', 'DEU', 'JPN', 'AUS', 'BRA', 'IND', 'KOR', 'TUR', 'MEX']

for competitor in competitors:
    for territory in key_territories:
        price = fetch_price(competitor.id, territory)

Step 3: Generate Comparison Report

## Competitor Pricing Analysis — {Category}

### Price Comparison (Monthly Subscription)

| App | USA | UK | Germany | Japan | India | Brazil | Turkey |
|-----|-----|-----|---------|-------|-------|--------|--------|
| Your App | $9.99 | £9.99 | €10.99 | ¥1,500 | ₹799 | R$54.90 | ₺149.99 |
| Competitor A | $7.99 | £6.99 | €7.99 | ¥1,000 | ₹349 | R$29.90 | ₺59.99 |
| Competitor B | $12.99 | £11.99 | €12.99 | ¥1,800 | ₹499 | R$44.90 | ₺99.99 |
| Market Avg | $10.32 | £9.66 | €10.66 | ¥1,433 | ₹549 | R$43.23 | ₺103.32 |

### Insights

- **India:** You're 45% above market average. Consider reducing to improve competitiveness.
- **Turkey:** You're 45% above market average. High-growth market, price sensitivity high.
- **Japan:** You're aligned with market. No immediate action needed.
- **USA:** You're 3% below market. Room to increase if value proposition is strong.

Quick Reference — API Endpoints

TaskMethodEndpointAuth
Lookup app priceGETitunes.apple.com/lookup?id={id}&country={cc}Public
Search appsGETitunes.apple.com/search?term={q}&media=softwarePublic
List subscription price pointsGET/v1/subscriptions/{id}/pricePoints?filter[territory]={cc}JWT
Get price equalizationsGET/v1/subscriptionPricePoints/{id}/equalizationsJWT
List IAP price pointsGET/v2/inAppPurchases/{id}/pricePoints?filter[territory]={cc}JWT
Set subscription pricePOST/v1/subscriptionPricesJWT
Set IAP price schedulePOST/v1/inAppPurchasePriceSchedulesJWT
List territoriesGET/v1/territoriesJWT

Caching Strategy

To avoid rate limits and improve performance:

DataCache DurationStorage
iTunes Lookup prices24 hoursLocal file
Premium Index7 daysLocal file
PPP data30 daysReference file
Territory codesPermanentReference file
Price points24 hoursLocal file

Reference Files

FilePurpose
territory-codes.mdAll 175 territory codes, currencies, and regions
ppp-data.mdWorld Bank PPP conversion factors
apple-pricing-api.mdAPI authentication and endpoint details
index-methodology.mdPremium Index calculation methodology

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

app-store-screenshots

No summary provided by upstream source.

Repository SourceNeeds Review
General

app-store-aso-localization

No summary provided by upstream source.

Repository SourceNeeds Review
General

app-store-reviews

No summary provided by upstream source.

Repository SourceNeeds Review
Research

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Repository SourceNeeds Review
84.8K94.2Kanthropics