# Google Play Store Reviews Scraper & API (`automationnation/google-play-reviews-scraper`) Actor

Scrape Google Play reviews for any app: rating, text, date, author, thumbs-up, app version and the developer's reply, newest first, thousands per app, any country and language. Only-new mode for review monitoring.

- **URL**: https://apify.com/automationnation/google-play-reviews-scraper.md
- **Developed by:** [Nathan Carter](https://apify.com/automationnation) (community)
- **Categories:** Developer tools, Automation, Marketing
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.05 / 1,000 reviews

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 Store Reviews Scraper & API

**Google Play Store Reviews Scraper is an Apify Actor that extracts reviews for any app on Google Play.** Each review comes with its star rating, text, date, author, thumbs-up count, app version and the developer's reply, newest first and thousands per app, at $0.08 per 1,000 reviews.

It works as a **Google Play reviews API**:

- call it from code
- schedule it to monitor new reviews
- let AI agents (Claude, ChatGPT, Cursor) use it through Apify's MCP server

#### Quick facts

- **What you get, one row per review:**
  - stars, review text, date, the reviewer's public name, thumbs-up count
  - the app version it was written for
  - the developer's reply and its date, plus a link to the review
  - app name, developer, overall rating and app URL
- **Any app, any country, any language:** paste Google Play URLs, package names (`com.spotify.music`) or just app names (`Spotify`).
- **Thousands of reviews per app**, newest first, most relevant first or by rating. Star filters such as "1 and 2 stars only" for complaints.
- **Only new reviews:** scheduled runs return just the reviews you haven't seen. Repeats aren't charged.
- **Price:** $0.08 per 1,000 reviews (less on paid Apify plans). Apify's free $5 monthly credit covers over 60,000 reviews.
- **Also reads App Store apps** when you give an App Store URL or ID, past the usual 500-review limit.
- **AI agents:** connect `https://mcp.apify.com?tools=automationnation/google-play-reviews-scraper`.

### What can you do with Google Play reviews?

- **Product and engineering teams.** See what users complain about after each release: filter 1 and 2 stars, group by app version.
- **App store optimisation (ASO).** Find the words users use, the features they ask for and how ratings move over time.
- **Competitor research.** Pull reviews of rival apps and compare what people praise and hate.
- **Customer support.** Track developer replies: which reviews got one, how fast, and what was said.
- **AI and analytics.** Feed clean review data into sentiment analysis, topic modelling or an LLM. For a ready-made AI report of bugs, feature requests and critical issues, see [App Store & Google Play Reviews Scraper + AI](https://apify.com/automationnation/app-store-review-miner).

### How to scrape Google Play reviews

1. Click **Try for free** (or **Start**).
2. Add apps: a Google Play URL, a package name such as `com.duolingo`, or an app name such as `Duolingo`.
3. Set **Max reviews per app**, the sort order, and optionally a star range, country and language.
4. Click **Start**. 100 reviews take a few seconds. Download JSON, CSV or Excel, or use the API.
5. For monitoring, tick **Only new reviews** and schedule the Actor daily.

#### Input example

```json
{
  "apps": ["com.spotify.music", "https://play.google.com/store/apps/details?id=com.duolingo", "Notion"],
  "maxReviewsPerApp": 500,
  "sort": "newest",
  "country": "us",
  "language": "en",
  "minRating": 1,
  "maxRating": 2
}
```

#### Output example

```json
{
  "platform": "Google Play",
  "appId": "com.spotify.music",
  "appName": "Spotify: Music and Podcasts",
  "country": "us",
  "reviewId": "993bbb82-c859-451b-9ee0-8d81e12f8e58",
  "rating": 3,
  "text": "ads are boring and offensive but I like this app",
  "date": "2026-10-02T08:12:00.224Z",
  "userName": "(the reviewer's public name)",
  "thumbsUp": 0,
  "appVersion": "9.1.88.2204",
  "replyText": "Hello. Appreciate the feedback, we'll pass it along to the Ads team. For an ad-free experience, we'd recommend checking out our Premium plans…",
  "replyDate": "2026-04-29T18:58:29.185Z",
  "reviewUrl": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=993bbb82-c859-451b-9ee0-8d81e12f8e58",
  "developer": "Spotify AB",
  "appRating": 4.35,
  "appRatingsCount": 36417981,
  "appUrl": "https://play.google.com/store/apps/details?id=com.spotify.music",
  "scrapedAt": "2026-10-03T09:57:15.429Z"
}
```

#### Output fields

| Field | Description |
|---|---|
| `platform`, `appId`, `appName`, `country` | Which app and storefront |
| `reviewId`, `rating`, `title`, `text`, `date` | The review; `rating` is 1 to 5 stars, `date` is ISO |
| `userName` | The reviewer's public display name |
| `thumbsUp` | How many people found the review helpful |
| `appVersion` | App version the review was written for |
| `replyText`, `replyDate` | The developer's reply, when there is one |
| `reviewUrl` | Link to the review on Google Play |
| `developer`, `appRating`, `appRatingsCount`, `appUrl` | App details, on every row (switch off with "Add app details") |

The **Run summary** (key-value store `OUTPUT`) lists each app with its review count and average rating.

### How much does it cost?

$0.08 per 1,000 reviews on Apify's Free plan, and less on paid plans. Apps that can't be found and reviews already returned by earlier runs (Only new reviews) are free. Apify's free $5 monthly credit covers over 60,000 reviews.

### Review monitoring: Only new reviews

Tick **Only new reviews** and schedule the Actor, for example daily. Each run returns only the reviews that earlier runs with the same app, country and sort didn't return, and stops paging as soon as it reaches reviews it has seen. Add a Slack, email or webhook integration to get new 1-star reviews as they arrive.

### Use it with AI agents (MCP)

**Hosted:** add `https://mcp.apify.com?tools=automationnation/google-play-reviews-scraper` to Claude, ChatGPT, Cursor or another MCP client, and sign in with Apify.

**Local (Claude Desktop or Cursor config):**

```json
{
  "mcpServers": {
    "google-play-reviews": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "automationnation/google-play-reviews-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

Then ask, for example, "What are the top complaints in Duolingo's 1-star Google Play reviews this month?"

### Integrations and API

```bash
curl -X POST "https://api.apify.com/v2/acts/automationnation~google-play-reviews-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"apps":["com.spotify.music"],"maxReviewsPerApp":100}'
```

Python and JavaScript: the `apify-client` package with Actor ID `automationnation/google-play-reviews-scraper`. n8n, Make, Zapier, Google Sheets, Slack and webhooks work through Apify's integrations.

### FAQ

**How many reviews can I get?**
Thousands per app for popular apps; the Actor pages through Google Play until it reaches your limit or the last review.

**Can I get reviews in other languages and countries?**
Yes. Set `language` (en, de, es, fr, pt, ja, …) and `country` (us, gb, de, in, br, …).

**Does it include the developer's replies?**
Yes, `replyText` and `replyDate` whenever the developer replied.

**Can I get App Store reviews too?**
Yes, paste App Store URLs or IDs and set the App Store countries. The Actor reads the review API behind apps.apple.com, so it goes past the 500-review limit of Apple's public feed. There is also a dedicated [App Store Reviews Scraper](https://apify.com/automationnation/app-store-reviews-scraper).

**Is it legal to scrape Google Play reviews?**
Reviews are public, but they include reviewers' display names. Use the data for analysis and follow the privacy laws that apply to you, such as GDPR.

### More from AutomationNation

- **[App Store Reviews Scraper](https://apify.com/automationnation/app-store-reviews-scraper)**: App Store reviews in any country, past the usual 500-review limit, with developer replies.
- **[App Store & Google Play Reviews Scraper + AI](https://apify.com/automationnation/app-store-review-miner)**: turns reviews into an AI report of bugs, feature requests and critical issues per app.
- **[Google Trends Scraper & API](https://apify.com/automationnation/google-trends-scraper)**: interest over time, by region and city, rising queries and Trending now.
- **[Google Jobs Scraper](https://apify.com/automationnation/google-jobs-scraper)**: job listings with salaries and employer apply links in 26 countries.

Feedback or a missing field? Open an issue on the Actor's **Issues** tab. Fixes usually ship within a day.

# Changelog

This Actor's version history is a separate document: https://apify.com/automationnation/google-play-reviews-scraper/changelog.md

# Actor input Schema

## `apps` (type: `array`):

Google Play app URLs, package names (com.spotify.music) or app names (Spotify). App Store URLs and IDs work too.

## `maxReviewsPerApp` (type: `integer`):

Google Play returns thousands of reviews for popular apps.

## `sort` (type: `string`):

Order Google Play returns reviews in.

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

Two-letter country code, e.g. us, gb, de, in, br.

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

Review language code, e.g. en, de, es, fr, pt, ja.

## `minRating` (type: `integer`):

Only reviews with at least this many stars (e.g. 1 and max 2 for complaints).

## `maxRating` (type: `integer`):

Only reviews with at most this many stars.

## `onlyNewReviews` (type: `boolean`):

Return only reviews that earlier runs with the same app, country and sort didn't return. Schedule it daily to monitor reviews; repeats aren't charged.

## `includeAppDetails` (type: `boolean`):

App name, developer, overall rating and app URL on every row.

## `countries` (type: `array`):

Only for App Store apps: storefronts to read reviews from, e.g. \["us", "gb"]. Leave empty to use the country in each App Store URL, or the Country above.

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

Apple limits review requests per IP, so App Store apps are read through Apify Proxy (datacenter IPs by default). Google Play doesn't need it.

## Actor input object example

```json
{
  "apps": [
    "com.spotify.music"
  ],
  "maxReviewsPerApp": 50,
  "sort": "newest",
  "country": "us",
  "language": "en",
  "minRating": 1,
  "maxRating": 5,
  "onlyNewReviews": false,
  "includeAppDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `reviews` (type: `string`):

One row per review: stars, text, date, author and app details.

## `replies` (type: `string`):

No description

## `allData` (type: `string`):

No description

## `summary` (type: `string`):

Per app and country: reviews returned, average rating, status and notes.

# 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 = {
    "apps": [
        "com.spotify.music"
    ],
    "maxReviewsPerApp": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automationnation/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 = {
    "apps": ["com.spotify.music"],
    "maxReviewsPerApp": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("automationnation/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 '{
  "apps": [
    "com.spotify.music"
  ],
  "maxReviewsPerApp": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call automationnation/google-play-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automationnation/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/bhqhSP6Hkg3Inkgom/builds/s1U2jQmxNwMfzL4qW/openapi.json