Revenue estimates and their limits
/apps/metrics/revenue/worldwide (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
lowandhighare 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.