Fetch app reviews
Returns customer reviews for the specified App Store app. Supports filtering by platform, country, language, and pagination. Each review includes rating, title, body text, version, and date. Billing is per page actually fetched — the response includes a `pagesFetched` field and you are charged 1 credit per page retrieved (not per page requested).
/reviews Reviews https://api.fetchlayer.dev/appstore/reviews Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
appId string required App Store app ID (numeric).
country string optional Two-letter country code. (default: us)
platforms string[] optional Filter by one or more platforms: iphone, ipad, mac, appletv, watch, realityDevice.
lang string optional Language code (e.g. en, ja).
geo string optional Two-letter geo code for regional results.
pages number optional Number of pages to fetch. Billed per page actually retrieved (see `pagesFetched` in the response). (default: 1)
reviewsPerPage number optional Reviews per page (max 20). (default: 20)
sort string optional Sort order: recent (default) or helpful. (default: recent)
Response Fields
reviews
Fetch app reviews
id string Unique review identifier.
rating number Star rating (1-5).
title string Review title.
body string Full review text.
author string Reviewer display name.
version string App version reviewed.
date string ISO 8601 review date.
helpfulCount number Number of users who found this helpful.
pagesFetched number Number of pages actually fetched. Billing is multiplied by this value (1 page = 1 credit). You are only charged for pages that were actually retrieved, not the number requested.
Request
curl -X POST "https://api.fetchlayer.dev/appstore/reviews" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"appId":"1234567890","country":"us","pages":1}'Response
{
"reviews": [
{
"id": "r123",
"rating": 5,
"title": "Great app",
"body": "Love using this every day!",
"author": "User123",
"version": "10.1.0",
"date": "2026-07-28T12:00:00Z",
"helpfulCount": 12
}
],
"pagesFetched": 1
}