# 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:** Automation, 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.11 / 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.

### Do you need an API key? No. Is there a free tier? Yes.

The two things people search for in this category, measured, are **free** and
**API key**: `app store reviews api`, `apple app store reviews api`.

So, plainly:

- **No API key.** Nothing to register for, nothing to rotate, no key to leak in
  a repo. The source is a public API published deliberately by its owner.
- **No proxy setup.** The source does not bot-wall datacenter addresses, so the
  default works.
- **Pay per result, not per month.** There is no subscription and no minimum.
  Rows that error or that your filters drop are **not charged**.
- **Free to try.** Run it with the prefilled input and see real rows before
  deciding anything.

### 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.

### Both stores, one table

| | Apple App Store reviews | Google Play Store reviews |
|---|---|---|
| Source | Apple's official customer-reviews RSS feed | the same public endpoint the Play website itself calls |
| Depth | up to ~500 per app, Apple's own cap | paginated properly, not capped at one page |
| Key needed | none | none |

Set `platform` to `ios`, `android` or `both`. Both stores return the same field
names, so an **Apple App Store reviews** export and a **Google Play reviews**
export stack into one file without any reshaping.

**Countries and languages.** `country` and `language` are passed through to each
store, so reviews come back per storefront: `us`, `gb`, `de`, `fr`, `es`, `it`,
`jp`, `kr`, `br`, `in`, `il` and the rest. Review text is written in the local
language, which is exactly why the filter exists: run one country at a time to
keep a sentiment pass monolingual, or run several to see how a complaint differs
by market.

### 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.

### The rest of this set

Four Actors over the same two stores, each answering a different question:

- **[App Store & Google Play Scraper](https://apify.com/glitchbound/app-store-scraper)**: the app itself: ratings, price, metadata
- **[App Store Top Charts Scraper](https://apify.com/glitchbound/app-charts-scraper)**: what is ranking today, by country and category
- **[App Store Developer Portfolio Scraper](https://apify.com/glitchbound/app-developer-scraper)**: every app one publisher has shipped

# 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. You can paste the URL instead of the identifier, e.g. https://play.google.com/store/apps/details?id=com.spotify.music works.

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

Pull from one store or both in the same run. Most competing Actors cover only one store, while 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.

## `maxItems` (type: `integer`):

A hard ceiling on rows for the entire run, across every target. The per-target limits above cap each one separately, so fifty targets at twenty each is still a thousand rows; this caps the total. The run stops cleanly when it is reached and nothing beyond that point is fetched or charged. Leave empty for no ceiling.

## 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/actors/1h90irTQCz02vqoE4/builds/KypJ6XgKyyUAGOXq4/openapi.json
