Google Play Reviews

1 credit per call

Get Google Play reviews for one or more apps in one or more languages.

POST/api/v1/tools/google/play/reviews

Parameters

appsstring[]required

Package names or Google Play links, such as "com.spotify.music" or "https://play.google.com/store/apps/details?id=com.spotify.music". Add at least one. Repeated apps are read once.

languagesstring[]

Review languages, such as "en", "de", or "zh-TW". Defaults to ["en"]. The value "all" picks every supported language, with English first. Each app is read in each language.

countrystring

Two-letter Google Play country code, such as "us" or "de". Defaults to "us".

sortstring

Review order: "newest" or "relevant". Defaults to "newest".

ratingsnumber[]

Star ratings to keep, from 1 to 5. Each chosen rating has its own maxReviews limit. Omit for all ratings.

sinceDatestring

Keep reviews from this date on, such as "2026-01-31". A date and time is also accepted. With the "newest" order, the read stops at the first page older than this date.

untilDatestring

Keep reviews up to this date, such as "2026-03-31". A date with no time includes the whole day. It must not be before sinceDate.

keywordsstring[]

Keep a review only when its text contains at least one of these words. Letter case is ignored.

excludeKeywordsstring[]

Drop a review when its text contains any of these words. Letter case is ignored.

developerReplystring

Keep reviews "with" a developer reply, "without" one, or "any". Defaults to "any".

appVersionsstring[]

Keep reviews about these app versions only, such as ["9.0.12"]. A review that shows no version is dropped when this filter is set.

minHelpfulVotesnumber

Keep reviews with at least this many helpful votes. Defaults to 0.

maxReviewsnumber

The most reviews for each app, language, and chosen rating. Defaults to 100. Use 0 for every review. The whole call returns no more reviews than your plan allows, and never more than 100,000. A call with a limit above 0 that asks for more than your plan allows fails with max_reviews_exceeded.

includeAppDetailsboolean

Add the details of each app, such as name, developer, category, rating, and price. Defaults to false.

Response Schema

dataobject

Google Play reviews result

reviewsobject[]

Reviews in the order of the request. A field with no value is left out of the review.

countnumber

Number of reviews returned

notesstring[]

Why the result may be incomplete, such as an app that the country does not offer, a read that stopped early, or the review limit of the plan. Empty when every matching review was read.

appsobject[]

Present when includeAppDetails is true. One record for each app that the country offers: id, name, country, url, description, category, iconUrl, contentRating, developer, rating, ratingCount, price, currency.

metaobject

Request metadata

toolstring

Tool name (google-play-reviews)

creditsUsednumber

Credits used: 1 per call

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/play/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "apps": ["com.spotify.music"],
    "languages": ["en", "de"],
    "country": "us",
    "ratings": [1],
    "maxReviews": 50
  }'

Response Example

{
  "data": {
    "reviews": [
      {
        "id": "a1b2c3d4-0000-4000-8000-000000000001",
        "appId": "com.spotify.music",
        "appName": "Spotify: Music and Podcasts",
        "language": "en",
        "rating": 1,
        "text": "Playback stops when the screen turns off.",
        "author": {
          "name": "Dana K."
        },
        "date": "2026-11-08T09:12:33.000Z",
        "appVersion": "9.0.12.567",
        "helpfulVotes": 12,
        "developerReply": {
          "author": "Spotify Ltd.",
          "text": "Sorry to hear that. Please check the battery settings for the app.",
          "date": "2026-11-08T15:40:00.000Z"
        },
        "url": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=a1b2c3d4-0000-4000-8000-000000000001"
      }
    ],
    "count": 1,
    "notes": []
  },
  "meta": {
    "tool": "google-play-reviews",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/google/play/reviews \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"apps": ["com.spotify.music"],

"languages": ["en", "de"],

"country": "us",

"ratings": [1],

"maxReviews": 50

{

"data": {

"reviews": [

{

"id": "a1b2c3d4-0000-4000-8000-000000000001",

"appId": "com.spotify.music",

"appName": "Spotify: Music and Podcasts",

"language": "en",

"rating": 1,

"text": "Playback stops when the screen turns off.",

"author": {

"name": "Dana K."

"date": "2026-11-08T09:12:33.000Z",

"appVersion": "9.0.12.567",

"helpfulVotes": 12,

"developerReply": {

"author": "Spotify Ltd.",

"text": "Sorry to hear that. Please check the battery settings for the app.",

"date": "2026-11-08T15:40:00.000Z"

"url": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=a1b2c3d4-0000-4000-8000-000000000001"

}

"count": 1,

"notes": []

"meta": {

"tool": "google-play-reviews",

"creditsUsed": 1,

"requestId": "req_abc123"

}