App Intelligence

The /reports/estimates resource gives you download and revenue estimates for any app on the iOS App Store and Google Play.

The data returned is based on our proprietary estimation models.

Getting Download and Revenue Estimate Totals

Request

GET /reports/estimates?start_date={start_date}&end_date={end_date}&products={products}&countries={countries}

Arguments

Argument	Type	Description
start_date	Date	(yyyy-MM-dd) First date to report on, inclusive. With a granularity other than daily, we round it down to the nearest period. Default: the earliest data available.
end_date	Date	(yyyy-MM-dd) Last date to report on, inclusive. With a granularity other than daily, we round it up to the nearest period. Default: the latest data available.
group_by	List	One or more pivots, separated by commas. Available pivots: product, country, date, and store.
products	List	(productId \| productId1, productId2, …) Products to include in the response. Default: all active products in your account.
countries	List	(isoCode \| isoCode1;isoCode2;isoCodeN) Countries to limit the report to. Get country codes from /data/countries. Default: all countries.
format	String	Output format: JSON or CSV. Defaults to JSON. Note: With `format=csv`, we don’t fully serialize sub-objects (like the product in /revenue/products/…), only their reference, to avoid repetition.

Response

Field	Description
downloads	The estimated number of downloads the app has seen, from all supported countries, in the specified period.
revenue	The estimated net revenue the app has earned from paid downloads, in-app purchases, and subscriptions, from all supported countries, in the specified period.

Example Response

// /reports/estimates?start_date=-30&products=213666962

{
"downloads": 1344045,
"revenue": "15275690.00"
}

Getting Download and Revenue Details

Request

GET /reports/estimates/?group_by={group_by}&start_date={start_date}&end_date={end_date}&products={products}&countries={countries}&format={format}

Arguments

Argument	Type	Description
start_date	Date	(yyyy-MM-dd) First date to report on, inclusive. With a granularity other than daily, we round it down to the nearest period. Default: the earliest data available.
end_date	Date	(yyyy-MM-dd) Last date to report on, inclusive. With a granularity other than daily, we round it up to the nearest period. Default: the latest data available.
group_by	List	One or more pivots, separated by commas. Available pivots: product, country, date, and store.
products	List	(productId \| productId1, productId2, …) Products to include in the response. Default: all active products in your account.
countries	List	(isoCode \| isoCode1;isoCode2;isoCodeN) Countries to limit the report to. Get country codes from /data/countries. Default: all countries.
format	String	Output format: JSON or CSV. Defaults to JSON. Note: With `format=csv`, we don’t fully serialize sub-objects (like the product in /revenue/products/…), only their reference, to avoid repetition.

Response

Like other /reports routes, you can group the response by one value or combine several to get a nested response. The breakdown changes, but the innermost objects keep the format of the totals object above.

Example Response Grouped by Day

// GET /reports/estimates/?group_by=dates&start_date=-30&products=213666962

{
  "2020-10-19": {
    "downloads": 38998,
    "revenue": "456766.00",
    "date": "2020-10-19"
  },
    "2020-10-20": {
      "downloads": 39783,
      "revenue": "446742.00",
      "date": "2020-10-20"
  },
  ...
}

Example Response Grouped by Country

// GET /reports/estimates/?group_by=country&start_date=-30&products=213666962

{
  "UA": {
    "downloads": 3958,
    "revenue": "5749.00",
    "iso": "UA",
    "country": "Ukraine"
  },
  "US": {
    "downloads": 384994,
    "revenue": "14810563.00",
    "iso": "US",
    "country": "United States"
  },
  ...
}

Example Response Grouped by Date and Country

// GET /reports/estimates/?group_by=date,country&start_date=-30&products=213666962

{
  "2020-10-19": {
    "US": {
      "downloads": 11723,
      "revenue": "441926.00",
      "date": "2020-10-19",
      "iso": "US",
      "country": "United States"
    },
    ...
  },
  ...
}