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
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, 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 |
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 |
Last Modified: 15 Sept 2022