App Store
App Store reviews API
Get an app’s App Store reviews. Call the App Store reviews API and get JSON back in one request. 1 credit per call. Failed calls cost nothing.
POST
Get an app's App Store reviews
Returns an app’s App Store reviews. The app is identified by its URL or ID.
Request
Exactly one ofappUrl or appId is required. A request that sets both, or none, fails with invalidRequest.
Response
If successful, the response body contains the standard envelope.data.results[] contains a page of the app’s reviews.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Billing
Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.Pagination
Results are paginated. To retrieve the next page, incrementpage. An empty data.results indicates the last page. The maximum value of page is 500.
Related methods
- App Store app: Accepts the same
appId. Returns an app’s details from the App Store.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Link to the App Store app, like https://apps.apple.com/us/app/notes/id1110145109. Send this or appId.
App Store app id, like 1110145109. Send this or appUrl.
ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.
Pattern:
^[A-Za-z]{2}$Available options:
newest, helpful, highest, lowest Page number, starting at 1.
Required range:
1 <= x <= 500