Google Play Store Reviews API - Fetch App Reviews

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.

POST /reviews Reviews
https://api.fetchlayer.dev/playstore/reviews
OpenAPI JSON

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
    }
  }
}
Product overview Google Play Store API: what it returns, pricing and use cases