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 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

Example Request


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

Example Response


Last Modified: 16 Dec 2022


Automate Your Workflow With 42matters’ APIs


Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs:



Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!