# App Store Reviews & ASO Scraper (`devilscrapes/app-store-reviews-aso-scraper`) Actor

Unified Google Play + Apple App Store review scraper with ASO rollup signals — rating distribution, trend, velocity, and keyword frequency across both stores in one run. Pay-Per-Event, no login, no API key.

- **URL**: https://apify.com/devilscrapes/app-store-reviews-aso-scraper.md
- **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community)
- **Categories:** Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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/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

<div align="center">
  <img src=".actor/icon.svg" width="160" alt="Devil Scrapes mark" />

## App Store Reviews & ASO Scraper

**💰 ~$1.20–1.50 / 1 000 results**  ·  pay only for results  ·  no credit card to try

*We do the dirty work so your dataset stays clean.* 😈

Scrape Google Play **and** Apple App Store reviews for the same apps in one run, normalized to a single schema, with an optional per-app ASO rollup — rating distribution, rating trend, review velocity, and praise/complaint keyword frequency.

</div>

***

**Status: scaffold.** This README is a placeholder skeleton written by
`actor-scaffolder`. Full store-listing copy (Features / Use cases / How
to use it / FAQ, etc.) is finalized by `actor-readme-curator` at publish
time — see `docs/specs/app-store-reviews-aso-scraper/spec.md` and
`design.md` for the authoritative shape of this Actor.

### TL;DR

Give it a list of apps — each with a Google Play package name and/or an
Apple App Store numeric id — and it returns one unified row per review
from whichever store(s) you supplied, plus (optionally) one ASO rollup
row per app summarizing rating distribution, trend, velocity, and
keyword-frequency praise/complaints. Both leading single-store
incumbents on the Apify Store cover only one platform each; this Actor's
whole point is bundling both in one run with a shared schema.

### 📥 Inputs

| Field | Type | Default | Notes |
|---|---|---|---|
| `apps` | `array` | *(see prefill)* | List of `{ playPackageName, appleAppId, appleCountryCode, label }` objects. Each entry needs at least one of `playPackageName` / `appleAppId`. |
| `maxReviewsPerApp` | `integer` | `200` | Per-store cap; Apple is hard-capped at ~50 by its own feed regardless. |
| `playHl` | `string` | `"en"` | Google Play RPC `hl` (language) param. |
| `playGl` | `string` | `"us"` | Google Play RPC `gl` (country) param. |
| `includeRollup` | `boolean` | `true` | Emit the per-app ASO rollup row in addition to individual review rows. |
| `proxyConfiguration` | `object` | unset | Apify Proxy editor — optional; neither source endpoint required a proxy during recon. |

### 📤 Outputs

Two row shapes coexist in one dataset:

- **Review row** (`store: "google_play" \| "app_store"`) — one per
  review: `app_label`, `app_id`, `review_id`, `author_name`, `rating`,
  `title`, `content`, `review_date`, `app_version`, `thumbs_up_count`,
  `developer_reply_content`, `developer_reply_date`, `scraped_at`.
- **ASO rollup row** (`row_type: "aso_rollup"`) — one per app:
  `stores_included`, `total_reviews_sampled`, `rating_distribution`,
  `average_rating`, `rating_trend_monthly`, `review_velocity_per_day`,
  `top_praise_keywords`, `top_complaint_keywords`, `scraped_at`.

Full field tables and examples: `docs/specs/app-store-reviews-aso-scraper/spec.md`
"Output Shape".

### 💰 Pricing

Pay-Per-Event, target blended price **$1.00–1.50 per 1,000 results**:

| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.05 | One-off warm-up charge per run |
| `review-scraped` | $0.0012 | Per review row written to the dataset |
| `rollup-computed` | $0.005 | Per ASO rollup row written (once per app) |

### Example

```json
{
  "apps": [
    {
      "playPackageName": "com.instagram.android",
      "appleAppId": "389801252",
      "appleCountryCode": "us",
      "label": "Instagram"
    }
  ],
  "maxReviewsPerApp": 50,
  "includeRollup": true
}
```

### Changelog

See `CHANGELOG.md`.

***

<div align="center">

Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of opinionated public-data Actors. Honest pricing, real engineering, zero fine print.

</div>

# Actor input Schema

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

List of logical apps to scrape. Each entry needs at least one of playPackageName / appleAppId (playPackageName: Google Play package name, e.g. "com.instagram.android"; appleAppId: Apple numeric app id, e.g. "389801252"; appleCountryCode: 2-letter lowercase country code for the Apple storefront, default "us"; label: optional free-text name to tag output rows/rollup).

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

Cap on reviews fetched per store per app. Google Play paginates toward this cap; Apple is hard-capped at ~50 by the feed itself regardless of this value.

## `playHl` (type: `string`):

2-letter language code for the Google Play RPC's hl query param.

## `playGl` (type: `string`):

2-letter country code for the Google Play RPC's gl query param.

## `includeRollup` (type: `boolean`):

Emit one additional ASO rollup row per app (rating distribution, trend, velocity, praise/complaint keyword frequency) alongside the individual review rows.

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

Apify Proxy configuration. Optional — neither the Google Play RPC nor the Apple RSS/JSON feed required a proxy or hit anti-bot protection during recon. The RESIDENTIAL group is not provisioned on this account and is not set as a default.

## Actor input object example

```json
{
  "apps": [
    {
      "playPackageName": "com.instagram.android",
      "appleAppId": "389801252",
      "appleCountryCode": "us",
      "label": "Instagram"
    }
  ],
  "maxReviewsPerApp": 50,
  "playHl": "en",
  "playGl": "us",
  "includeRollup": true
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

All dataset items as JSON.

## `datasetItemsCsv` (type: `string`):

Same data exported to CSV.

## `datasetView` (type: `string`):

Open the run dataset in the Console.

# 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": [
        {
            "playPackageName": "com.instagram.android",
            "appleAppId": "389801252",
            "appleCountryCode": "us",
            "label": "Instagram"
        }
    ],
    "maxReviewsPerApp": 50,
    "playHl": "en",
    "playGl": "us",
    "includeRollup": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/app-store-reviews-aso-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": [{
            "playPackageName": "com.instagram.android",
            "appleAppId": "389801252",
            "appleCountryCode": "us",
            "label": "Instagram",
        }],
    "maxReviewsPerApp": 50,
    "playHl": "en",
    "playGl": "us",
    "includeRollup": True,
}

# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/app-store-reviews-aso-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": [
    {
      "playPackageName": "com.instagram.android",
      "appleAppId": "389801252",
      "appleCountryCode": "us",
      "label": "Instagram"
    }
  ],
  "maxReviewsPerApp": 50,
  "playHl": "en",
  "playGl": "us",
  "includeRollup": true
}' |
apify call devilscrapes/app-store-reviews-aso-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,devilscrapes/app-store-reviews-aso-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/qTKtIqR5aA5NPtlTY/builds/eggfpWhdQ4HiaeKKp/openapi.json