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
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 or rating. 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 5 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 |
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-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
This request can also be imported into Postman.
Check out our Postman integration guide.
Example Response
{
"number_results": 4,
"num_pages": 1,
"has_next": false,
"limit": 100,
"page": 1,
"package_name": "com.zhiliaoapp.musically",
"start_date": "2023-02-23",
"end_date": "2023-03-24",
"dates": [
"2023-02-26",
"2023-03-05",
"2023-03-12",
"2023-03-19"
],
"event_field": "number_ratings",
"min": 55093868,
"max": 55513580,
"avg": 55307763,
"results": [
{
"date": "2023-02-26",
"value": 55093868
},
{
"date": "2023-03-05",
"value": 55229828
},
{
"date": "2023-03-12",
"value": 55393774
},
{
"date": "2023-03-19",
"value": 55513580
}
]
}
Last Modified: 23 September 2021