Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Reviews Stats

Get all the stats related to the reviews entries about a specific app on the App Store in the selected country and based on several criteria like date, rating or even to search for a specific word or expression in the reviews's body.

get/apps/reviews/stats.json

Query parameters

appsstring required

Comma separated list of app IDs. Max 5 apps are allowed. <br/> <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank">How to find App IDs?</a>

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

languagestring

Two letter <a href="https://developers.apptweak.com/reference/country-codes#languages">language code</a>. <br/><b>Default:</b> us

device'iphone' | 'ipad' | 'android'

Choose a device from iphone, ipad or android. <br/><b>Default:</b> iphone

termstring

Term to search for in the review body. <br/><b>Default:</b> empty

start_datestring date

Start date of the period in format YYYY-MM-DD <br/><b>Default:</b> 30 days ago

end_datestring date

End date of the period in format YYYY-MM-DD<br/><b>Default:</b> empty

Response

200

OR

Example response

{
  "result": {
    "1094591345": {
      "reviews": {
        "daily": [
          {
            "date": "2022-05-01",
            "value": {
              "total": 25,
              "average": 3.32,
              "count": {
                "1": 6,
                "2": 2,
                "3": 5,
                "4": 2,
                "5": 10
              }
            }
          }
        ],
        "aggregate": {
          "total": 160,
          "average": 2.94375,
          "count": {
            "1": 57,
            "2": 16,
            "3": 18,
            "4": 17,
            "5": 52
          }
        }
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/reviews/stats.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "start_date": "2022-05-01",
        "end_date": "2022-05-07",
        "apps": [
          "1094591345"
        ],
        "min_rating": 1,
        "max_rating": 5
      },
      "cost": 17,
      "max_credit_cost": 17,
      "status": 200
    }
  }
}