Ratings allows you to fetch the evolution of the star-rating of an app over time
Please note that the most recent rating of an app can be found in the metadata request. This request is intended to perform calculations on the evolution of this rating over time.
On the Apple appstore, ratings are defined per application, per country.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
The first date for which to get data in YYYY-MM-DD format
The response will contain one entry per day between start_date and end_date
The last date for which to get data in YYYY-MM-DD format
The response will contain one entry per day between start_date and end_date
GET /ios/applications/284882215/ratings.json?country=fr&start_date=2018-10-01&end_date=2018-10-03
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/284882215/ratings.json?country=fr&start_date=2018-10-01&end_date=2018-10-03"The response to the application ratings request is a hash specifying the start and end date of the selected time period and an array containing one entry per day in the period.
The first object of the array correspond to the start_date, the second to the day following the start_date and so on. The last object corresponds to the end_date.
The detected start date of the period.
The detected end date of the period.
An ordered list of objects, Each objects contains the number of 1,2,3,4 and 5 stars votes, the total number of votes, and the average score of the app.
{
"content": {
"ratings": [
{
"1": 4704,
"2": 1713,
"3": 1933,
"4": 2041,
"5": 4406,
"total": 14797,
"avg": 2.982
},
{
"1": 4720,
"2": 1720,
"3": 1945,
"4": 2066,
"5": 4436,
"total": 14887,
"avg": 2.985
},
{
"1": 4759,
"2": 1736,
"3": 1954,
"4": 2079,
"5": 4459,
"total": 14987,
"avg": 2.983
}
],
"start_date": "2018-10-01 00:00:00 +0000",
"end_date": "2018-10-03 00:00:00 +0000"
},
"metadata": {
"request": {
"path": "/applications/284882215/ratings.json",
"store": "ios",
"params": {
"country": "fr",
"start_date": "2018-10-01T00:00:00+00:00",
"end_date": "2018-10-03T00:00:00+00:00",
"id": "284882215",
"format": "json"
},
"performed_at": "2018-11-09 15:05:19 UTC"
},
"content": {
}
}
}