Fetch app reviews
Fetch Google Play reviews using an app ID or listing URL. Supports pagination, sorting, rating and keyword filters, date windows, language, device type, and app version filters. If you only know the app by name, run the search endpoint first and pass the `appId` it returns.
/reviews Reviews https://api.fetchlayer.dev/playstore/reviews Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
appIdOrUrl string required Google Play package ID or full app listing URL.
startPage integer optional The page of results to start from.
pages integer optional How many pages of results to return.
maxReviews integer optional Maximum number of reviews to return.
reviewsPerPage integer optional Reviews requested per page (1-200).
sortBy string optional Sort order: newest, mostRelevant, or rating.
rating integer optional Only return reviews with this star rating (1-5).
ratingFilter number[] optional Only return reviews matching any listed star rating.
keywords string[] optional Only return reviews containing one or more keywords.
endDate string optional Stop at this review date (YYYY-MM-DD).
recentDays integer optional Only return reviews from the most recent number of days.
uniqueOnly boolean optional Remove duplicate reviews.
language string[] optional Only return reviews matching these language codes.
deviceType string optional Device filter: mobile, tablet, or chromebook.
appVersion string[] optional Only return reviews for these app versions.
delayMs integer optional Delay in milliseconds between page requests.
Response Fields
reviews
Fetch app reviews
appId string Google Play package ID.
reviews object[] Matching review records.
reviews[].reviewId string Unique review identifier.
reviews[].rating number Star rating from 1 to 5.
reviews[].reviewer string Reviewer display name.
reviews[].date string Day the review was posted, as YYYY-MM-DD (UTC).
reviews[].body string Full review text.
reviews[].appVersion string | null App version reviewed, when available.
reviews[].timestamp integer When the review was posted, as Unix time in seconds (e.g. 1787047200). Multiply by 1000 for a JavaScript Date.
reviews[].language string Detected review language.
reviewCount number Number of reviews returned.
pagesRequested number Number of pages requested.
scrapedAt string ISO 8601 time the result was produced.
analysis.totalReviews number Total reviews included in the analysis.
analysis.averageRating number Average rating across returned reviews.
analysis.ratingDistribution object Counts grouped by star rating.
Request
curl -X POST "https://api.fetchlayer.dev/playstore/reviews" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"appIdOrUrl":"com.spotify.music","pages":1,"reviewsPerPage":20,"sortBy":"newest"}'Response
{
"appId": "com.spotify.music",
"reviews": [
{
"reviewId": "review-id",
"rating": 5,
"reviewer": "Example user",
"date": "2026-08-18",
"body": "Great app",
"timestamp": 1787047200,
"language": "en"
}
],
"reviewCount": 1,
"pagesRequested": 1,
"scrapedAt": "2026-08-18T10:00:01.000Z",
"analysis": {
"totalReviews": 1,
"averageRating": 5,
"ratingDistribution": {
"5": 1
}
}
}