# Revenue estimates and their limits

[`/apps/metrics/revenue/worldwide`](https://appmanai.com/docs/reference/operations/appMetricsRevenueWorldwide.html) (and the MCP
tool `app_metrics_revenue_worldwide`) returns an app's estimated revenue from store purchases
over the last 30 days, worldwide and split by country. **Neither store publishes revenue, so
every figure — Google Play and App Store alike — is an estimate.** Read this before quoting one.

## What you get

| Field | Meaning |
| --- | --- |
| `period` | The window: `from` and `to` (the last 30 days, ending yesterday), and `days_with_estimate`, how many of those days the estimate covers. |
| `currency` | The currency of every amount. `USD` unless you pass `currency`. |
| `month.gross` | What users paid in the window, worldwide. |
| `month.net` | What the developer keeps after the store's commission. |
| `value`, `low`, `high` | The estimate and its likely range. The true figure usually falls between `low` and `high`. |
| `bucket` | The estimate as a size band: `min`, `max` (`null` for the top band) and a `label` such as `10M+`. |
| `accuracy` | How far to trust this app's estimate: `high` or `low`. |
| `typical_error` | How far off estimates like this one typically are, as a multiplier — `low` and `high` sit about that factor below and above `value`. |
| `countries` | The split by country, largest first: `country`, `gross`, `net` and `days` (days with an estimate). The countries add up to `month`. A small app can come with a total and no split. |
| `rates_source` | Where the exchange rates come from when `currency` is not `USD`; `null` otherwise. |

An app that sells nothing through the store reads `0` with an empty `countries` list, and the
call is not charged. An app with no estimate at all is a `NOT_FOUND` error, also not charged.

## Limits

- **Approximate for any single app.** One app's figure can be well off in either direction —
  that is what `low` and `high` are for. It is most useful for sizing an app and for comparing
  apps of the same kind; don't present it as an exact revenue figure.
- **Store purchases only.** Money an app makes outside the store — ads, sales on its own
  website — is not included, so an ad-funded app can read close to zero.
- **Net uses one flat commission for every app.** Real rates differ by store programme and
  subscription age, so an app's actual net can be higher or lower.
- **The last 30 days only.** There is no history and no other window. A figure covering fewer
  days (`days_with_estimate`) is less certain.

## Currency

`currency` takes an ISO 4217 code — `EUR`, `GBP`, `JPY` — in any case. An unknown code is a
`BAD_REQUEST`, and is not charged.

## Both stores

Pass `store=android` with a package name (`com.tinder`) or `store=ios` with the numeric App
Store id (`547702041`). There is no per-country request: one call returns the worldwide total
and every country together.