Google Play Weekly App Ratings History API. Retrieve comprehensive historical app ratings insights for any Android app available on Google Play.
GET https://data.42matters.com/api/v2.0/android/apps/ratings.json
3
3 QPS
Large or above.
default 30 days (up to 5 years with 'Historical Package')
| 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. |
| Status Code | Indication | Content-Type | Body | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Everything is OK | application/json |
|
|||||||||||||||||||||||||||||||||||||||||||||
| 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 |
Ratings for the TikTok app on Google Play:
{
"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
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
HubSpot
Slack
Intercom
Pipedrive
Zendesk
Gekoboard
Klipfolio
Dynamics