App Store iOS App Download Estimates History API

---

App Store iOS App Download Estimates History API. Retrieve comprehensive historical app download estimates insights for any Android app available on Apple App Store.

You can find previous API version documentation here.

Definition

Endpoint:

GET https://data.42matters.com/api/v5.0/ios/apps/download_estimates.json

Hits per request:

100

Rate limit:

3 QPS

Required plan:

Large or above.

Historical data:

default 30 days (up to 2 years with 'Historical Package')

Parameters

Name	Required	Description	Available Values	Default
access_token	required	Your access token for using this API. You can get it for FREE by signing up .
id	required	The app ID on the Apple App Store - (e.g for Facebook the ID is 284882215).	Existing App ID on Apple App Store
country	optional	ISO code of the country. If no country is specified, results of top 5 countries will be returned. It is possible to query downloads for individual countries in one request by using comma-separated countries like US,DE,FR or ALL for all countries. To return countries that have the most downloads use TOP - top country, TOP_5 - top 5 countries, TOP_10 - top 10 countries, TOP_20 - top 20 countries.	List of Supported Countries.	TOP_5
aggr	optional	Results will be aggregated based on your selection. Leaving aggr empty will return all results with country code. Available options for aggr are: daily - results aggregated daily. weekly - results aggregated weekly. monthly - results aggregated monthly. region - results will be aggregated by supported regions based on the countries requested. Supported regions: Europe, Asia, East Asia, Central Asia, South Asia, Southeast Asia, Western Asia, North America, Oceania, South America, Africa.	daily, weekly, monthly, region.
start_date	optional	The start date of the report	A valid date in the format yyyy-MM-dd, for example: 2020-05-24
end_date	optional	The end date of the report.	A valid date in the format yyyy-MM-dd, for example: 2020-05-30
days	optional	Set the date range from yesterday to the specified number of days in the past.	Without Historical Package: Last 30 days. With Historical Package: up to 2 years	30
sort_order	optional	Ordering by date	desc or asc	asc
device_type	optional	Supported device types. If device_type is empty or equals to any then all device types are returned.	Value Information iphone iPhone devices ipad iPad devices any All devices
limit	optional	Number of ranks to return.	1-100	100
page	optional	Page based on the limit parameter, used for pagination.	1 - max pages. There is a limit of 10000 results that can be iterated.	1
callback	optional	If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code	Indication	Content-Type	Body
200	Everything is OK	application/json	Attribute Type Description number_results Integer Total number of results for this query num_pages Integer Maximum number of pages it's possible to iterate has_next Boolean Flag indicating if there is a next page available limit Integer Number of results per request page Integer Current page number trackId String Numeric unique identifier for the app assigned by Apple start_date Date A date in the format: yyyy-MM-dd end_date Date A date in the format: yyyy-MM-dd dates Array of dates Sorted list of dates in the response countries Array of countries strings List of countries in the response regions Array of region objects List of region objects containing region name and code in the response. Is available only when using aggregation region. total_downloads Integer Total number of downloads for selected country in requested period download_estimates Array of Objects Sorted list of download estimates objects in the response. Each download estimate contains: array of dates. Array of dates contains date - date string or region - region code, total - total number of downloads, country - country code if no aggr param value passed. If a total is null, it means the app does not have data for this country on that date.
404	The trackId is not found	application/json	Error object
402	Your request exceeds what's allowed by your current subscription plan	application/json	Error object
403	Your access token is not valid	application/json	Error object
429	Your request rate is over the limit	application/json	Error object

Example Request

Download Estimates for the TikTok app on App Store:

https://data.42matters.com/api/v5.0/ios/apps/download_estimates.json?id=835599320&days=10&access_token=YOUR_ACCESS_TOKEN

---

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

Last Modified: 15 Sept 2022