# App Store & Google Play Reviews Scraper (`fujiwaranosai/app-reviews-scraper`) Actor

Reviews from Apple App Store and Google Play in one run: ratings, text, version, date, developer replies. Multi-country, rating and keyword filters, and only-new mode for monitoring.

- **URL**: https://apify.com/fujiwaranosai/app-reviews-scraper.md
- **Developed by:** [Sai Data Tools](https://apify.com/fujiwaranosai) (community)
- **Categories:** Developer tools, E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.15 / 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.

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

### What does App Reviews Scraper do?

**App Reviews Scraper** collects user reviews from the **Apple App Store** and **Google Play** in a single run and returns them in one normalized format: rating, title, text, author, app version, date, helpful votes and the developer's reply.

Mix apps from both stores, collect several countries at once, filter by rating or keywords, and schedule it with **Only new reviews** to monitor what users say every day.

### Why use it?

- 📱 **Both stores in one actor** — App Store and Google Play reviews side by side, same fields.
- 🌍 **Multi-country** — each app is collected for every country you list (us, gb, de, br, mx, es…).
- ⭐ **Filters** — min/max stars (e.g. only 1–2★ complaints), keywords ("crash", "login", "price"), last N days.
- 🆕 **Only new reviews** — on scheduled runs returns just the reviews that appeared since the previous run.
- 💬 **Developer replies** (Google Play) and **app version** of each review.
- ⚡ **Fast and cheap** — no browser; thousands of reviews in seconds.

### Use cases

- **Product & UX research**: find the bugs and feature requests users mention most.
- **Competitor monitoring**: track what users love and hate about competing apps, per country.
- **Customer support alerts**: send new 1★ reviews to Slack or email (schedule + integrations).
- **Sentiment analysis & AI**: feed clean review text into your LLM or analytics pipeline.

### How to use it

Add apps in **Apps**, one per line, in any of these forms:

- App Store URL → `https://apps.apple.com/us/app/instagram/id389801252`
- Google Play URL → `https://play.google.com/store/apps/details?id=com.spotify.music`
- `appstore:389801252` or `play:com.spotify.music` (a bare numeric id is App Store, a package name is Google Play)

Then pick countries, language (Google Play), how many reviews per app and the filters.

#### Input example

```json
{
  "apps": ["https://apps.apple.com/us/app/instagram/id389801252", "play:com.spotify.music"],
  "countries": ["us", "gb"],
  "language": "en",
  "maxReviewsPerApp": 200,
  "sort": "newest",
  "maxRating": 2,
  "onlyNew": false
}
```

### Output example

```json
{
  "store": "play",
  "app_id": "com.spotify.music",
  "app_name": "Spotify: Music and Podcasts",
  "country": "us",
  "language": "en",
  "review_id": "a1b2c3…",
  "rating": 2,
  "title": null,
  "text": "Since the last update the app keeps crashing when…",
  "author": "A Google user",
  "app_version": "9.0.98.465",
  "date": "2026-11-09T18:22:41+00:00",
  "thumbs_up": 14,
  "reply_text": "Hi there, sorry to hear that…",
  "reply_date": "2026-11-09T20:03:10+00:00",
  "review_url": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=a1b2c3…",
  "scraped_at": "2026-11-10T04:00:00+00:00"
}
```

A `SUMMARY` record in the run's key-value store lists how many reviews were found per app and country (or the error, if any).

### Limits worth knowing

- The App Store's public reviews feed serves up to **500 most recent reviews per app and country** (10 pages × 50). Add more countries to get more reviews.
- Google Play has no such cap; use **Max reviews per app** to control size and cost.
- Ratings-only entries (stars without text) are not shown by the stores, so they are not included.

### Free trial and pricing

- 🎁 **The first 500 reviews of every Apify account are free** — test it with your own data before paying anything.
- After that: **$0.15 per 1,000 reviews** returned, nothing else (no monthly rental). Set a *max charge* per run if you want a hard cap.
- The run status shows how many free reviews you have left.

### Use it from code, n8n, Make or Zapier

**One API call that runs the Actor and returns the results:**

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

**Python:**

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("fujiwaranosai/app-reviews-scraper").call(run_input={"apps": ["play:com.spotify.music"], "maxReviewsPerApp": 100, "maxRating": 2})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**No-code:** use the official Apify integration in **n8n**, **Make** or **Zapier** ("Run an Actor" + "Get dataset items"), or schedule it in Apify and connect the run to Slack, Google Sheets, Google Drive or a webhook. Example flow: every new 1★/2★ review → Slack, a Google Sheet or your support tool.

### Is it legal?

The actor reads reviews that the stores publish openly for anyone to read. Reviews include the public display name the reviewer chose. If you store or process this data, make sure your use complies with the stores' terms and with privacy laws such as GDPR in your jurisdiction.

### Feedback

Missing a field, a store or a country? Open an issue on the **Issues** tab — the actor is actively maintained.

# Actor input Schema

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

One per line: an App Store URL (apps.apple.com/us/app/.../id389801252), a Google Play URL (play.google.com/store/apps/details?id=com.instagram.android), 'appstore:<id>' or 'play:<package>'. Mix both stores freely.

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

Two-letter country codes (us, gb, de, br, mx, es...). Each app is collected for each country.

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

Two-letter language code for Google Play reviews (en, es, pt, de...).

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

App Store serves at most 500 recent reviews per country through its public feed.

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

Order in which reviews are collected.

## `reviewedWithinDays` (type: `integer`):

Only reviews from the last N days (with 'Newest first'). Empty = no date limit.

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

Keep reviews with at least this many stars (1-5).

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

Keep reviews with at most this many stars (e.g. 2 to get only complaints).

## `keywords` (type: `array`):

Keep reviews whose title or text contains one of these words (e.g. 'crash', 'login', 'price').

## `onlyNew` (type: `boolean`):

Remembers the reviews already returned for this same set of apps/countries and returns only new ones. Ideal for scheduled monitoring.

## Actor input object example

```json
{
  "apps": [
    "https://apps.apple.com/us/app/instagram/id389801252",
    "play:com.spotify.music"
  ],
  "countries": [
    "us"
  ],
  "language": "en",
  "maxReviewsPerApp": 200,
  "sort": "newest",
  "onlyNew": false
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "apps": [
        "https://apps.apple.com/us/app/instagram/id389801252",
        "play:com.spotify.music"
    ],
    "countries": [
        "us"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("fujiwaranosai/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 = {
    "apps": [
        "https://apps.apple.com/us/app/instagram/id389801252",
        "play:com.spotify.music",
    ],
    "countries": ["us"],
}

# Run the Actor and wait for it to finish
run = client.actor("fujiwaranosai/app-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": [
    "https://apps.apple.com/us/app/instagram/id389801252",
    "play:com.spotify.music"
  ],
  "countries": [
    "us"
  ]
}' |
apify call fujiwaranosai/app-reviews-scraper --silent --output-dataset

```

## MCP server setup

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