> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing Intelligence

> Compare your IAP / subscription price against tracked competitors with percentile ranking.

The agent pulls live pricing from the iTunes Lookup API for your app and every tracked competitor, then ranks where you sit in the cohort.

## Effective price

For comparability we use the **lowest entry price** per app:

* Free app + IAPs → the cheapest IAP price (typically the entry sub)
* Paid app → the app price itself
* Free with no IAPs → excluded from comparison

This matches how users perceive the cost of getting started with an app.

## What you see

```
## 💸 Pricing Intelligence
Your effective entry price: USD 4.99
Competitor median: USD 9.99
Position: P15 (below median)

Competitor breakdown:
  • Acme Screenshots: USD 9.99 (3 IAPs)
  • PixelPro: USD 14.99 (5 IAPs)
  • SnapStitch: USD 4.99 (2 IAPs)
  • ScreenshotPro: USD 19.99 (4 IAPs)
  • CaptureKit: free / n/a
```

`P15` means **15th percentile** — you're cheaper than 85% of competitors. Labels:

| Percentile | Label                 |
| ---------- | --------------------- |
| 0-10       | 🔥 cheapest in cohort |
| 11-40      | below median          |
| 41-60      | near median           |
| 61-90      | above median          |
| 91-100     | premium-priced        |

## In the structured report

The `pricing` field of `DailyReport`:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "positioning": "below_median",
  "detail": "Your $4.99 entry price is at P15 vs a $9.99 competitor median. You're leaving $5+ on the table for potentially the same conversion.",
  "recommendation": "Test a $7.99 price point for 14 days and measure subscription start rate."
}
```

## Why this matters

Most indie devs underprice. The agent gives you the **median** and the **distribution** so you can decide if you're optimizing for volume or margin — not just guessing.

It also catches:

* Competitors raising prices (signal you can too)
* Competitors going free (signal of a freemium pivot — defend or follow)
* New IAP tiers competitors added (test if you should add equivalents)

## Limitations

* **iTunes Lookup is regional** — we query the country you're analyzing, not your competitor's home market. For a global picture, run the agent across multiple `country` values.
* **Subscription tiers are fuzzy** — Apple doesn't expose subscription period in the lookup, so weekly vs annual subs at the same price can confuse the comparison. The agent flags this in the prose when it spots inconsistency.
* **Promotional pricing** — limited-time offers show as the discounted price. Re-runs days later will show the change.