List Apple App Store reviews
List customer reviews for an Apple App Store app with developer replies.
Headers
Get your API keyAPI key (`sfk_...`)
Numeric App Store app id, e.g. `284882215`. An id with the `id` prefix used in App Store links (`id284882215`) is also accepted.
min 1 chars · max 155 chars
Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, reviews and text are specific to it. A code Apple does not run a store for is refused. Default: `us`.
pattern: ^[a-zA-Z]{2}$
`recent` (newest first), `helpful` (Apple's own ranking), `favorable` (newest 5 star reviews only) or `critical` (newest 1 star reviews only). Default: `recent`.
one of: recent, helpful, favorable, critical
Page number (1-based), 20 reviews a page, up to page 5,000. A deep page of a very long list can come back empty with `depthLimited: true`; ask again or try another sort; stop at the first empty page. Default: 1.
≥ 1 · ≤ 5000
Endpoint-specific response payload.
`not_found` when the app, developer or storefront has no match. An app removed from the store, one that never existed and one not offered in this storefront all look the same.
one of: found, not_found
Storefront the reviews are from.
The app id asked for.
Sort used.
one of: recent, helpful, favorable, critical
Reviews on this page, in the order of the sort.
Review id.
Review title.
Review text.
Stars given (1 to 5).
≥ 1 · ≤ 5
When the review was posted or last edited (ISO-8601, UTC).
Whether the reviewer edited the review.
The reviewer. This list has no reviewer id.
Display name shown in the store.
The developer's reply, when there is one.
Reply id.
Reply text.
When the reply was posted or last changed (ISO-8601, UTC).
True when this deep page of a very long list is empty because it is temporarily unavailable, not because the list ended. Ask again, or try another sort or storefront.
Page state. The last page with rows can still say `hasMore: true`; stop at the first empty page.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/apple-app-store/apps/284882215/reviews?sort=recent" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store reviews page.