Google Play Weekly App Ratings History API

Google Play Weekly App Ratings History API. Retrieve comprehensive historical app ratings insights for any Android app available on Google Play.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/android/apps/ratings.json

Hits per request:

Rate limit:

3 QPS

Required plan:

Large or above.

Historical data:

default 30 days (up to 7 years 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
event_field	optional	Field type to filter for	number_ratings, rating, ratings_1, ratings_2, ratings_3, ratings_4, ratings_5. See Android App Object for more details about these fields.	number_ratings
start_date	optional	The start date of the report	A valid date in the format yyyy-MM-dd, for example: 2020-05-24
end_date	optional	The end date of the report.	A valid date in the format yyyy-MM-dd, for example: 2020-05-30
days	optional	Set the date range from yesterday to the specified number of days in the past.	Without Historical Package: Last 30 days. With Historical Package: up to 7 years	1
sort_order	optional	Ordering by date	desc or asc	asc
limit	optional	Number of results to return.	1-100. Free trial results limited to 5.	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.
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-dd
end_date	Date	A date in the format: yyyy-MM-dd
dates	Array of dates	Sorted list of dates in the response
event_field	String	Field type
min	Double	Minimum value for the period
max	Double	Maximum value for the period
avg	Double	Average from values for the period
results	Array of Objects	Sorted list of objects in the response. Each rating object contains: date, value

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

Ratings for the TikTok app on Google Play:

https://data.42matters.com/api/v2.0/android/apps/ratings.json?p=com.zhiliaoapp.musically&days=30&event_field=number_ratings&access_token=YOUR_ACCESS_TOKEN

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

Example Response

{
  "number_results": 5,
  "num_pages": 1,
  "has_next": false,
  "limit": 100,
  "page": 1,
  "package_name": "com.zhiliaoapp.musically",
  "start_date": "2025-04-20",
  "end_date": "2025-05-19",
  "dates": [
    "2025-04-20",
    "2025-04-27",
    "2025-05-04",
    "2025-05-11",
    "2025-05-18"
  ],
  "event_field": "number_ratings",
  "min": 65846427,
  "max": 66128940,
  "avg": 65990978,
  "results": [
    {
      "date": "2025-04-20",
      "value": 65846427
    },
    {
      "date": "2025-04-27",
      "value": 65919318
    },
    {
      "date": "2025-05-04",
      "value": 65998289
    },
    {
      "date": "2025-05-11",
      "value": 66061913
    },
    {
      "date": "2025-05-18",
      "value": 66128940
    }
  ]
}

Last Modified: 2 Nov 2023

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: