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.

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 number optional

Page number at which scraping starts.

pages number optional

Number of pages to scrape.

maxReviews number optional

Maximum number of reviews to return.

reviewsPerPage number optional

Reviews requested per page (1-200).

sortBy string optional

Sort order: newest, mostRelevant, or rating.

rating number 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 number 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 number 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

Human-readable review date.

reviews[].body string

Full review text.

reviews[].appVersion string | null

App version reviewed, when available.

reviews[].timestamp string

ISO 8601 review timestamp.

reviews[].language string

Detected review language.

reviewCount number

Number of reviews returned.

pagesRequested number

Number of pages requested.

scrapedAt string

ISO 8601 scrape completion time.

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",
      "body": "Great app",
      "timestamp": "2026-08-18T10:00:00.000Z",
      "language": "en"
    }
  ],
  "reviewCount": 1,
  "pagesRequested": 1,
  "scrapedAt": "2026-08-18T10:00:01.000Z",
  "analysis": {
    "totalReviews": 1,
    "averageRating": 5,
    "ratingDistribution": {
      "5": 1
    }
  }
}

{
  "error": "Invalid API key"
}