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/v2.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 total monthly active users for those
countries or ALL for all countries.
To return country that has most monthly active users use TOP as a country code.
|
List of Supported Countries. |
US |
aggr |
optional |
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. |
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 |
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 |
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 |
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.
|
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,
total - total number of monthly active users.
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: 6 Apr 2022