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

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 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 Long Total number of results for this query num_pages Long Maximum number of pages it's possible to iterate has_next Boolean Flag indicating if there is a next page available limit Long Number of results per request page Long 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 List of countries strings List of countries in the response regions List of region objects List of region objects containing region name and code in the response. Is available only when using aggregation region. dates List of dates Sorted list of dates in the response mau_avg Long Average number of monthly active users for selected country(s) in requested period. mau List of Objects Sorted list of monthly active users objects in the response. Each monthly active users object contains: list of dates. List 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. You will be charged 1 hit	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/v3.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: 05 Oct 2023