# Google Play Reviews Scraper (`webdatalabs/google-play-reviews-scraper`) Actor

Scrape Google Play reviews at scale with features competitors don't offer. Perfect for sentiment analysis, competitor research, and automation workflows.

- **URL**: https://apify.com/webdatalabs/google-play-reviews-scraper.md
- **Developed by:** [WebDataLabs](https://apify.com/webdatalabs) (community)
- **Categories:** SEO tools, Marketing, Developer tools
- **Features:** Limited permissions
- **Stats:** 187 total users, 6 monthly users, 99.1% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $7.00 / 1,000 review scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Play Reviews Scraper

Paste one or more Google Play app URLs, get their reviews as clean, flat rows.

### What you get

One row per review, 14 fields (12 with reviewer names turned off), ready for a spreadsheet, a
database, or an n8n/Zapier/Make step:

| Field | Type | Description |
|-------|------|-------------|
| `reviewId` | string | Unique Google Play review ID. Stable across runs - use it as your primary key. |
| `appId` | string | Package ID of the app the review belongs to |
| `rating` | integer | Star rating, 1-5 |
| `text` | string | null | Review body. `null` when the user left stars but wrote nothing. |
| `userName` | string | null | Reviewer display name. Left out when **Include reviewer names** is off. |
| `userImage` | string | null | Reviewer avatar URL. Left out when **Include reviewer names** is off. |
| `reviewDate` | string | null | When it was posted, ISO 8601 UTC |
| `thumbsUp` | integer | null | How many people marked the review helpful (often `0`) |
| `version` | string | null | App version the reviewer was running |
| `replyText` | string | null | The developer's public reply, `null` if there is none |
| `replyDate` | string | null | When the developer replied, ISO 8601 UTC |
| `url` | string | null | Direct link to the review on Google Play |
| `criteriaRatings` | array | null | Structured tags Google attaches to some reviews (mostly games) |
| `scrapedAt` | string | When this run fetched the review, ISO 8601 UTC |

**Fields Google does not provide come back as `null`.** They are never filled with `""`,
`"Anonymous"`, `0`, or today's date. An empty cell means Google had nothing, not that the scraper
guessed.

#### Leaving out reviewer names

Reviewer names and avatars are included by default. They are personal data, so if you don't need
them, turn off **Include reviewer names** (`includeAuthorNames`): the `userName` and `userImage`
keys are then left out of the rows entirely - they are not set to `null`. Everything else - the
other fields, the row count and the price per review - is the same either way.

#### How often each optional field is actually filled

Measured on real runs, not estimated. Fill rates depend entirely on the app:

| Field | Minecraft (3,816 reviews) | Spotify (300) | Duolingo (80) |
|-------|--------------------------|---------------|---------------|
| `text`, `userName`, `userImage`, `reviewDate`, `url`, `thumbsUp` | 100% | 100% | 100% |
| `version` | 74.7% | 84.3% | 95.0% |
| `criteriaRatings` (non-empty) | 23.5% | 30.7% | 8.8% |
| `thumbsUp` greater than 0 | 33.8% | 4.7% | 1.3% |
| `replyText` / `replyDate` | 0% | 9.0% | 0% |

`replyText` is 0% for developers who do not reply publicly. That is a real finding about the app,
not a scraper failure.

#### Example row

```json
{
  "reviewId": "b12666f2-b2b9-4fa7-b02a-e40271faabeb",
  "appId": "com.mojang.minecraftpe",
  "rating": 5,
  "text": "this pal is the best game ever bro",
  "userName": "A Google user",
  "userImage": null,
  "reviewDate": "2026-08-09T14:05:35.853Z",
  "thumbsUp": 0,
  "version": "1.26.40.5",
  "replyText": null,
  "replyDate": null,
  "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe&reviewId=b12666f2-b2b9-4fa7-b02a-e40271faabeb",
  "criteriaRatings": [
    { "criteria": "vaf_app_quality_battery_efficiency", "rating": 1 },
    { "criteria": "vaf_app_quality_performance", "rating": 3 }
  ],
  "scrapedAt": "2026-08-10T14:13:51.162Z"
}
```

### Input

Six settings, one of them required, plus two under **Advanced**.

| Setting | Type | Default | Description |
|---------|------|---------|-------------|
| **Google Play App URLs** (`startUrls`) | array | - | **Required.** Full `https://play.google.com/store/apps/details?id=...` URLs, one per app. Bare package IDs are rejected by Apify's URL validation, so paste the whole URL. |
| **Max Reviews** (`maxReviews`) | integer | 100 | Reviews to keep per app, 1-100,000 |
| **Sort By** (`sortBy`) | select | Most Recent | `NEWEST`, `RATING` (highest first) or `HELPFULNESS` |
| **Rating Filter** (`rating`) | select | All reviews | `ALL`, `NEGATIVE` (1-2 stars only) or `POSITIVE` (4-5 stars only) |
| **Language** (`language`) | string | `en` | Two-letter language code. Google returns only reviews written in that language - use the app's main language (`pt` for a Brazilian app). |
| **Include reviewer names** (`includeAuthorNames`) | boolean | on | Includes `userName` and `userImage` in every row. Turn off to leave names and avatars out. |
| **Country (storefront)** (`country`) | string | `us` | Advanced. Two-letter Google Play storefront. A `gl=` parameter in an app URL (for example `&gl=BR`) overrides it for that app. |
| **Proxy Configuration** (`proxyConfiguration`) | object | Apify Proxy | Advanced. Not used - kept so existing saved tasks keep working. Requests go out directly from the Apify platform, which Google Play accepts. |

```json
{
  "startUrls": [
    { "url": "https://play.google.com/store/apps/details?id=com.duolingo" },
    { "url": "https://play.google.com/store/apps/details?id=com.spotify.music" }
  ],
  "maxReviews": 500,
  "sortBy": "NEWEST",
  "rating": "NEGATIVE"
}
```

#### Two things worth knowing

- **Language decides which reviews exist.** Google returns only reviews written in the requested
  language. An English run on a Brazilian app can come back empty while the same app has
  Portuguese reviews - the run then succeeds and its status message tells you to switch language.
- **`Rating Filter` is applied after fetching.** Google has no server-side star filter here, so
  asking for 500 negative reviews reads several thousand reviews to find them. It costs you nothing
  extra - you are only billed for the rows you receive - but it takes longer.

### How many reviews can you actually get?

Short answer: **as many as you ask for, up to your run's cost limit.**

- Google serves reviews 150 at a time. The actor pages through them until it has what you asked for
  or Google runs out.
- **Verified on 2026-08-10:** a single run against `com.mojang.minecraftpe` requesting 30,000
  reviews read 200 consecutive full pages - 30,000 reviews, zero short pages, in about 2 minutes.
  Google did not cut pagination off. Older versions of this actor stopped at 15,000; that limit is
  gone.
- The real ceiling for most runs is Apify's **Maximum cost per run** budget, not Google. When the
  run reaches it the actor stops, says so in the log, and reports how many reviews it actually
  delivered. Raise the limit in the run options if you need more in one go.

If a run stops early you will see the reason in the log: `max-reviews-reached`, `no-more-pages`,
`page-budget-exhausted`, or the charge-limit message. It is never silent.

### When the run fails

This actor is designed to fail loudly rather than return an empty dataset and call it a success.

- **App ID does not resolve** - reported per app by name, with the storefront and language it was
  looked up under. The other apps in the run continue.
- **All requested apps failed** - the run **fails** with a message listing every app ID and why. It
  does not exit green with zero rows.
- **Some apps worked, some did not** - the run succeeds, delivers the data it got, and prints a
  `Partial success` summary naming the failures.
- **App exists but no review matched your rating filter** - this succeeds with zero rows for that
  app. That is a real answer, and it is reported differently from "app not found".
- **App exists but has no reviews in your language** - this also succeeds with zero rows, and the
  run's status message names the app and suggests its home language. Only a failure to reach
  Google - not an empty answer from it - fails the run.

A per-app breakdown (status, reviews read, reviews delivered, pages fetched, stop reason) is saved
to the key-value store record **`STATS`** on every run.

### Pricing

Pay-per-event. Two events:

| Event | Charged |
|-------|---------|
| **Review scraped** | Once per review row delivered to your dataset |
| **Actor start** | Once per run, per GB of run memory |

Your Apify plan discounts both rates automatically - the exact price for your tier is shown in the
pricing box at the top of this page, and in the Console before you run. You are charged per review
row that reaches your dataset; rows that could not be delivered are not billed.

### Limitations, stated plainly

- Sub-ratings (`criteriaRatings`) use Google's own undocumented tag IDs. The numbers in them are
  small integers (1, 2, 3 observed), not star scores, and Google does not publish what they mean.
- No incremental / "only new reviews since last run" mode. Every run fetches from the top of the
  sort order. De-duplicate on `reviewId` if you run on a schedule.
- No webhook delivery from inside the actor. Use Apify's own webhooks or an integration on the run.
- Google does not expose a review title, so there is no `title` field.

### FAQ

**Where do I get the app URL?** Open the app on play.google.com and copy the address bar. It looks
like `https://play.google.com/store/apps/details?id=com.duolingo`.

**Can I scrape several apps at once?** Yes. Add one URL per app; `maxReviews` applies to each app
separately.

**How do I get only 1-2 star reviews?** Set Rating Filter to "Negative only". If you also set Sort
By to "Highest Rating" the actor switches you to "Most Recent" and says so, because sorting by
rating puts the negative reviews last.

**Why is `text` null on some rows?** Google Play lets people rate an app without writing anything.
Those reviews are real and are included, with `text: null`.

**How do I export to CSV?** Dataset tab -> Export -> CSV.

### Run it from the API

```bash
curl -X POST "https://api.apify.com/v2/acts/webdatalabs~google-play-reviews-scraper/runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "startUrls": [{ "url": "https://play.google.com/store/apps/details?id=com.duolingo" }],
    "maxReviews": 500,
    "sortBy": "NEWEST"
  }'
```

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('webdatalabs/google-play-reviews-scraper').call({
  startUrls: [{ url: 'https://play.google.com/store/apps/details?id=com.duolingo' }],
  maxReviews: 500,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

***

### Explore more of our actors

| Actor | Description |
|-------|-------------|
| [Shopify Scraper Pro](https://apify.com/webdatalabs/shopify-product-scraper) | Extract complete Shopify product data with variants and sales estimates |
| [Etsy Scraper Pro](https://apify.com/webdatalabs/etsy-scraper-pro) | Fast Etsy product scraper with ratings, reviews, and shop data |
| [Amazon Reviews Scraper](https://apify.com/webdatalabs/amazon-reviews-scraper) | Extract Amazon customer reviews for sentiment analysis |

The full catalogue is at [apify.com/webdatalabs](https://apify.com/webdatalabs).

### Need this data as a managed feed?

If you would rather receive this data on a schedule than run the Actor yourself, we can build and operate the feed: the fields you specify, the cadence you set, delivered to a dataset, S3, a webhook, or your database. Every scheduled run is checked against an agreed shape rather than assumed to be fine, missing values are reported as null instead of filled with placeholders, and repairing the collector when the source changes is covered by the monthly rate. Priced as a one-time setup fee plus a monthly rate, scoped in writing before anything is built.

**Contact:** support@webdatalabs.net

### Related actors

- [App Store Intelligence Pro - ASO & Rank Tracker](https://apify.com/webdatalabs/app-store-intelligence-pro) — ASO keyword difficulty and rank tracking
- [Amazon Reviews Scraper & Extractor](https://apify.com/webdatalabs/amazon-reviews-scraper) — review text, ratings and verified-purchase flags
- [Reddit Scraper Pro](https://apify.com/webdatalabs/reddit-scraper-pro) — posts and full comment threads
- [YouTube Shorts Scraper & Data Extractor](https://apify.com/webdatalabs/youtube-shorts-scraper) — Shorts metadata and engagement

Explore the full portfolio from [WebDataLabs](https://apify.com/webdatalabs).

### Support

Found a bug, or need a field that is missing? Open an issue on the **Issues** tab of this Actor and
it will be picked up there. You can also reach WebDataLabs through the support channel on our
[Store profile](https://apify.com/webdatalabs).

### Leave a review

Is this actor saving you time? A quick review on the Store helps other people find it — and tells us which fields to add next. **[Rate this actor →](https://apify.com/webdatalabs/google-play-reviews-scraper)**

### Legal Disclaimer

This actor is a general-purpose tool for analyzing publicly accessible web data. The user bears sole responsibility for ensuring their specific use complies with:

- Applicable laws (GDPR/DSGVO, copyright law)
- The target website's Terms of Service
- Apify's Terms of Service

The provider (webdatalabs) expressly disclaims liability for any unauthorized or unlawful use. By using this actor, the user agrees to indemnify the provider against any third-party claims arising from their use of the data.

***

*This tool is not affiliated with Google. All trademarks belong to their respective owners.*

# Actor input Schema

## `startUrls` (type: `array`):

Google Play app URLs to scrape reviews from. Add one URL per line.

## `maxReviews` (type: `integer`):

Maximum number of reviews to scrape per app

## `sortBy` (type: `string`):

How to sort reviews

## `rating` (type: `string`):

Filter reviews by star rating

## `language` (type: `string`):

Two-letter language code (en, de, fr, es, pt, etc.). Google only returns reviews written in this language, so use the app's main language - for example "pt" for a Brazilian app.

## `includeAuthorNames` (type: `boolean`):

Includes each reviewer's display name (userName) and avatar URL (userImage). On by default. Turn it off to leave names and avatars out - they are personal data, so skip them if you don't need them.

## `country` (type: `string`):

Two-letter Google Play storefront code (us, br, de, etc.). A gl= parameter in an app URL overrides this for that app. Leave as "us" unless the app is only published in another country.

## `proxyConfiguration` (type: `object`):

Not used - kept so existing saved tasks keep working. Requests go out directly from the Apify platform, which Google Play accepts.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
    }
  ],
  "maxReviews": 100,
  "sortBy": "NEWEST",
  "rating": "ALL",
  "language": "en",
  "includeAuthorNames": true,
  "country": "us",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `full_review_data` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
        }
    ],
    "maxReviews": 100,
    "sortBy": "NEWEST",
    "rating": "ALL",
    "language": "en",
    "includeAuthorNames": true,
    "country": "us"
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdatalabs/google-play-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe" }],
    "maxReviews": 100,
    "sortBy": "NEWEST",
    "rating": "ALL",
    "language": "en",
    "includeAuthorNames": True,
    "country": "us",
}

# Run the Actor and wait for it to finish
run = client.actor("webdatalabs/google-play-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
    }
  ],
  "maxReviews": 100,
  "sortBy": "NEWEST",
  "rating": "ALL",
  "language": "en",
  "includeAuthorNames": true,
  "country": "us"
}' |
apify call webdatalabs/google-play-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,webdatalabs/google-play-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vUH9LdVHsQqI3fjt4/builds/cikyg7txlu0oTVtmQ/openapi.json
