Application Ratings History

GET 2 Credits / Request + 1 Credit / Request / 30 days /ios/applications/{APPLICATION_ID}/ratings.json

Application Ratings History 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.

Application Ratings Request

On the Apple appstore, ratings are defined per application, per country.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

start_date: string 90 Days ago

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

end_date: string Yesterday

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/{APPLICATION_ID}/ratings.json

Request example
GET /ios/applications/284882215/ratings.json?country=fr&start_date=2018-10-01&end_date=2018-10-03
cURL example
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

Application Ratings History Response

The response to the application ratings history 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.

Object properties
start_date: string

The detected start date of the period.

end_date: string

The detected end date of the period.

ratings: array

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.

Response Example

{
  "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": {
    }
  }
}