# App Store & Google Play Reviews Scraper — Both Stores (`glitchbound/app-reviews-scraper`) Actor

Scrape user reviews from the Apple App Store AND Google Play in one run: rating, text, author, app version, date, thumbs-up and developer replies. Filter by star rating to mine complaints. Identical output shape for both stores.

- **URL**: https://apify.com/glitchbound/app-reviews-scraper.md
- **Developed by:** [Daniel Meshulam](https://apify.com/glitchbound) (community)
- **Categories:** AI, SEO tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.14 / 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## App Store & Google Play Reviews Scraper — Both Stores

Pull **user reviews from the Apple App Store AND Google Play in a single run**, with one identical output shape for both.

Most review scrapers cover one store. You end up buying two, running two, and reconciling two different formats. This does both at once.

### What you get per review

| Field | iOS | Android |
|---|---|---|
| Star rating | ✅ | ✅ |
| Review text | ✅ | ✅ |
| Review title | ✅ | — (Play has no titles) |
| Author name | ✅ | ✅ |
| App version reviewed | ✅ | ✅ |
| Date | ✅ | ✅ |
| Thumbs-up count | — | ✅ |
| Developer reply | — | ✅ |

### Mine complaints in one step

Set **Min rating 1** and **Max rating 2** and you get only the negative reviews — the fastest way to find bugs, churn reasons and feature requests. **You are charged only for reviews actually returned**, not for everything scanned.

```json
{
  "appIds": ["com.spotify.music", "com.spotify.client"],
  "platform": "both",
  "maxReviewsPerApp": 500,
  "minRating": 1,
  "maxRating": 2
}
```

### Use cases

- **Product research** — pull 1-star reviews for your competitors and read what their users hate
- **Churn analysis** — track complaints by app version to see which release broke things
- **LLM pipelines** — clean JSON, ready to summarise into themes
- **Review monitoring** — schedule it daily and get alerted to rating drops
- **ASO** — see which complaints show up in your category

### App IDs

Accepts any of three forms:

- Android package — `com.spotify.music`
- iOS numeric ID — `324684580`
- iOS bundle ID — `com.spotify.client` (resolved automatically)

Dotted IDs exist on both stores, so with **Platform = Both** the Actor checks each and returns whichever exists.

### Notes

- iOS uses Apple's **official reviews feed**; Apple serves up to ~500 per app.
- Google Play reviews come from the same public endpoint the Play website itself calls, paginated properly rather than capped at one page.
- Rows with an `error` field tell you exactly which lookup failed and why. **They are never charged.**
- Public review data only — no logins, no accounts, no personal data beyond the public display name attached to each review.

# Actor input Schema

## `appIds` (type: `array`):

Apps to pull reviews for, one per line. Accepts an Android package (com.spotify.music), an iOS numeric ID (324684580), or an iOS bundle ID (com.spotify.client). Dotted IDs exist on both stores, so with Platform = Both the Actor checks each.

## `platform` (type: `string`):

Pull from one store or both in the same run. Most competing Actors cover only one store — this returns both in a single, identical output shape.

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

How many reviews to scan per app, per store. Apple serves up to 500; Google Play goes deeper.

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

Which reviews to fetch first.

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

Only keep reviews at or above this rating. Set Min 1 / Max 2 to pull just the complaints — the fastest way to mine bugs and feature requests. You are only charged for reviews actually returned.

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

Only keep reviews at or below this rating.

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

Two-letter store country code (us, gb, de, il...). Reviews differ per country.

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

Two-letter language code, used for Google Play.

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

Keep Apify Proxy enabled for reliable Google Play requests.

## Actor input object example

```json
{
  "appIds": [
    "com.spotify.music"
  ],
  "platform": "both",
  "maxReviewsPerApp": 100,
  "sortBy": "mostrecent",
  "minRating": 1,
  "maxRating": 5,
  "country": "us",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

User reviews from the App Store and Google Play, with rating, text and author.

# 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 = {
    "appIds": [
        "com.spotify.music"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("glitchbound/app-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 = { "appIds": ["com.spotify.music"] }

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

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

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

```

## CLI example

```bash
echo '{
  "appIds": [
    "com.spotify.music"
  ]
}' |
apify call glitchbound/app-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=glitchbound/app-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/1h90irTQCz02vqoE4/builds/jamYee8Bsp1zPsoih/openapi.json
