Google Play App Download Estimates History API

---

Google Play App Download Estimates History API. Retrieve comprehensive historical app download estimates insights for any Android app available on Google Play.

You can find previous API version documentation here.

Definition

Endpoint:

GET https://data.42matters.com/api/v5.0/android/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 .
p	required	The package name identifying an Android application.	Any publicly available Android app package name
country	optional	ISO code of the country. If no country is specified, US will be used. 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
limit	optional	Number of results 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 package_name String The app package name (unique identifier) 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 package name 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 Google Play:

https://data.42matters.com/api/v5.0/android/apps/download_estimates.json?p=com.zhiliaoapp.musically&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