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

Hits per request:

150

Rate limit:

3 QPS

Required plan:

Large or above.

Historical data:

default 3 months (up to 1 year 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. 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

Example Request

Monthly Active Users Estimates for the Facebook app on Google Play:

https://data.42matters.com/api/v2.0/android/apps/mau.json?p=com.facebook.katana&access_token=YOUR_ACCESS_TOKEN

---

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

Example Response

Last Modified: 6 Apr 2022