Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Reviews Search

Get all 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/search.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

limitinteger

Number of reviews you want to fetch. <b>Max limit is 500</b> <br/><b>Default:</b> 100

offsetinteger

Index offset you want to apply to the reviews. <br/><b>Default:</b> 0

replied'true' | 'false' | 'nil'

Parameter to take replied (true), not replied (false) or all reviews (nil) into account. <br/><b>Default:</b> nil

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": {
    "1058959277": {
      "reviews": [
        {
          "country": "us",
          "application_id": "1058959277",
          "date": "2022-05-07T22:29:37Z",
          "rating": 1,
          "title": "Deal, or not",
          "body": "I got a deal for 25 dollars off my meal, sounds great right. No between delivery fee, service fee, this fee, fee for delivery right to me, so now I gotta pay you to bring my food right to me so it’s not cold? That’s insane. I got the cheapest food I could find and still paid 20 dollars in fees. Tell me where the actual deal is? \nI understand this is a business, but charging up cost on the food we are buying, plus multiple fees, plus everything else. I’m wondering where the actual service is. Pizza Hut and others have been delivering for years with a simple delivery charge, why you need to charge so much? Your employees use there own cars, they use there phones, we tip them, what does Uber eats do besides raise up prices and rob people to drive food a few blocks?",
          "body_length": 772,
          "id": "8647851367",
          "author": {
            "name": "dogjwncown",
            "type": "Customers",
            "id": 1406357412
          }
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/reviews/search.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "limit": 10,
        "start_date": "2022-01-01",
        "end_date": "2022-05-07",
        "apps": [
          "1058959277"
        ],
        "term": "cold",
        "min_rating": 1,
        "max_rating": 5
      },
      "cost": 11,
      "max_credit_cost": 11,
      "status": 200
    }
  }
}