Google Play App Monthly Active Users History API
Google Play App Monthly Active Users Estimates History API. Retrieve comprehensive historical app
monthly active users estimates
insights for any Android app available on Google Play.
Definition
Endpoint:
GET
https://data.42matters.com/api/v3.0/android/apps/mau.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, US will be used.
You can use multiple countries like US,DE,FR to get monthly active users for those
countries or ALL for all countries.
To return countries that have the most monthly active users 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:
monthly - results aggregated by month based on the countries requested
region - results aggregated by month and by 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. |
Supported aggregations: monthly, region. |
|
start_date |
optional |
The start date of the report |
A valid date in the format yyyy-MM, for example: 2022-01. Without Historical
Package: Last 3 months.
With Historical
Package: up to 1 year |
|
end_date |
optional |
The end date of the report. |
A valid date in the format yyyy-MM, for example: 2022-04. |
|
months |
optional |
Set the date range to the specified number of months in the past. |
Without Historical
Package: Last 3 months.
With Historical
Package: up to 1 year |
3 |
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 |
end_date |
Date |
A date in the format: yyyy-MM |
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.
|
dates |
Array of dates |
Sorted list of dates in the response |
mau_avg |
Integer |
Average number of monthly active users for selected country(s) in requested period. |
mau |
Array of Objects |
Sorted list of monthly active users objects in the response. Each monthly active users object
contains:
array of dates.
Array of dates contains
date - date string or region - region code if aggr=region
is used,
total - total number of monthly active users
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: 16 Dec 2022