# App Store & Google Play Review Scraper (`renzomacar/app-store-scraper`) Actor

Scrape Apple App Store and Google Play in one run — app reviews, ratings, metadata, top charts, and keyword rankings, in any country, with no API key. Pay-per-result alternative to Sensor Tower & data.ai for ASO research, review monitoring, and sentiment analysis. Both stores. No login.

- **URL**: https://apify.com/renzomacar/app-store-scraper.md
- **Developed by:** [Renzo Madueno](https://apify.com/renzomacar) (community)
- **Categories:** Developer tools, Marketing
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Review Scraper — Reviews, Ratings & ASO Data (No API Key)

Scrape **both the Apple App Store and Google Play in one run** — app reviews, ratings, metadata, top charts, and keyword rankings — in any country, with **no API key**. A pay-per-result alternative to Sensor Tower and data.ai for ASO research, review monitoring, and sentiment analysis.

⭐ **Using it and it works? [Leave a 30-second review](https://apify.com/renzomacar/app-store-scraper/reviews)** — and tell us what to add via the **Issues** tab. It's the single biggest thing that helps other developers find it.

### What does this App Store scraper do?

Three modes, both stores, multi-country:

- **Reviews + metadata** — full app details plus reviews (text, rating, version, date, helpful count, developer reply) and an automatic **review sentiment summary** (avg rating, % positive/negative, top keywords).
- **Top charts** — Apple App Store top free / paid / grossing by genre and country (ASO market intel).
- **Keyword ranking** — which apps rank for a search term, on each store (ASO rank tracking).

The only actor that does **both stores in one run, with no API key and pay-per-result pricing.**

### How to scrape App Store and Google Play reviews

1. Add **apps** — Apple IDs, Apple/Google URLs, Google package names, or app names. Mix freely.
2. Pick **platform** (apple / google / both), **countries**, and **maxReviewsPerApp**.
3. Run it — one clean JSON/CSV row per app, review, and summary.

```json
{ "apps": ["com.spotify.music", "324684580"], "platform": "both", "countries": ["us"], "maxReviewsPerApp": 200 }
````

### Reliability — built to actually finish your run

Built on **first-party Apple iTunes API/RSS + Google Play public endpoints** — not fragile full-page HTML scraping that breaks on every redesign. Every request has **automatic retry with backoff** (handles 429 and transient 5xx), and failures are **surfaced in the log**, not silently swallowed — so your scheduled jobs don't quietly return empty. Unified review schema across both stores, so you never special-case fields.

### App Store scraper comparison

| | This Actor | Apple-only scrapers | Google-only scrapers | Sensor Tower / data.ai |
|---|---|---|---|---|
| Apple App Store | ✅ | ✅ | ❌ | ✅ |
| Google Play | ✅ | ❌ | ✅ | ✅ |
| Both stores, one run | ✅ | ❌ | ❌ | partial |
| Reviews + charts + keyword ASO | ✅ | varies | varies | ✅ |
| Review sentiment summary | ✅ | ❌ | ❌ | ✅ |
| No API key / no subscription | ✅ | varies | ✅ | ❌ |
| Pay per result | ✅ | some rental | ✅ | ❌ |

### Pricing

Pay-per-result — no subscription:

| Event | Price |
|---|---|
| Actor start | $0.01 |
| App metadata | $0.005 |
| Reviews batch (per app) | $0.01 |
| Chart page / search query | $0.01 |

### Output example

```json
{ "type": "app", "platform": "google", "title": "Spotify", "rating": 4.3, "installs": "1B+", "inAppPurchases": "$6.99 - $203.88", "adSupported": true, "hasDataSafety": true, "developerEmail": "support@spotify.com", "screenshots": ["https://…"] }
{ "type": "review", "platform": "apple", "rating": 5, "title": "Love it", "text": "…", "version": "9.0", "date": "2026-06-20…", "helpfulCount": 12, "reply": null }
{ "type": "review-summary", "platform": "google", "reviewsAnalyzed": 200, "averageRating": 3.85, "positivePct": 70, "topKeywords": [{ "word": "premium", "count": 31 }] }
```

### Use cases

- **ASO research** — track ratings, top charts, and keyword rankings for your app and competitors, across both stores.
- **Review monitoring** — watch new reviews and developer replies by country; alert on rating drops.
- **Sentiment & ML** — pull thousands of reviews as clean JSON to feed an LLM, plus a ready-made sentiment summary.
- **Competitive intel** — compare metadata, tech, IAP pricing, and data-safety across rival apps.

### FAQ

**Does it cover both app stores?** Yes — Apple App Store and Google Play, side by side, multi-country, in one run.

**Do I need an API key?** No. It uses public first-party endpoints — no developer account, no login.

**How many reviews can I get?** Google Play supports deep pulls (thousands). Apple's public RSS feed caps at ~500 per app per country — so for maximum Apple depth, run multiple countries. The actor tells you in the log when the Apple cap is hit (no silent truncation).

### Other Actors by this author

Need finance, company, or research data too? See my [other Actors](https://apify.com/renzomacar) — Yahoo Finance, SEC EDGAR, Company Enrichment, Apple Podcasts, and Deep Research MCP.

***

Built by [Renzo Madueño](https://apify.com/renzomacar). Found a bug or want a field added? Open an **Issue** — I read and respond to every one.

# Actor input Schema

## `mode` (type: `string`):

reviews = app metadata + reviews. charts = ASO top charts. search = ASO keyword ranking (which apps rank for a term).

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

App names, Apple App Store IDs/URLs, or Google Play package names/URLs. E.g. "Notion", "477128284", "com.spotify.music".

## `searchTerms` (type: `array`):

Keywords to check app rankings for (ASO). Returns the ranked apps per term and country.

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

Which store(s) to use.

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

Two-letter country codes (e.g. us, gb, de).

## `includeReviews` (type: `boolean`):

Also scrape reviews, not just app metadata.

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

Per app, per country. Apple caps at ~500 via RSS; Google Play supports more.

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

Order in which reviews are pulled.

## `chartType` (type: `string`):

Which Apple chart to pull.

## `appleGenreId` (type: `integer`):

Optional App Store genre/category ID to filter charts (e.g. 6017 = Education, 6013 = Health & Fitness, 6014 = Games). Leave empty for overall.

## `limit` (type: `integer`):

Max apps to return per chart or per search term/country.

## Actor input object example

```json
{
  "mode": "reviews",
  "apps": [
    "com.spotify.music",
    "Notion"
  ],
  "searchTerms": [
    "meditation",
    "habit tracker"
  ],
  "platform": "both",
  "countries": [
    "us"
  ],
  "includeReviews": true,
  "maxReviewsPerApp": 100,
  "sort": "newest",
  "chartType": "topfree",
  "limit": 50
}
```

# 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",
        "Notion"
    ],
    "searchTerms": [
        "meditation",
        "habit tracker"
    ],
    "countries": [
        "us"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("renzomacar/app-store-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",
        "Notion",
    ],
    "searchTerms": [
        "meditation",
        "habit tracker",
    ],
    "countries": ["us"],
}

# Run the Actor and wait for it to finish
run = client.actor("renzomacar/app-store-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 '{
  "apps": [
    "com.spotify.music",
    "Notion"
  ],
  "searchTerms": [
    "meditation",
    "habit tracker"
  ],
  "countries": [
    "us"
  ]
}' |
apify call renzomacar/app-store-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "App Store & Google Play Review Scraper",
        "description": "Scrape Apple App Store and Google Play in one run — app reviews, ratings, metadata, top charts, and keyword rankings, in any country, with no API key. Pay-per-result alternative to Sensor Tower & data.ai for ASO research, review monitoring, and sentiment analysis. Both stores. No login.",
        "version": "0.1",
        "x-build-id": "31A5EIe45bTweZGjQ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/renzomacar~app-store-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-renzomacar-app-store-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/renzomacar~app-store-scraper/runs": {
            "post": {
                "operationId": "runs-sync-renzomacar-app-store-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/renzomacar~app-store-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-renzomacar-app-store-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "reviews",
                            "charts",
                            "search"
                        ],
                        "type": "string",
                        "description": "reviews = app metadata + reviews. charts = ASO top charts. search = ASO keyword ranking (which apps rank for a term).",
                        "default": "reviews"
                    },
                    "apps": {
                        "title": "Apps (reviews mode)",
                        "type": "array",
                        "description": "App names, Apple App Store IDs/URLs, or Google Play package names/URLs. E.g. \"Notion\", \"477128284\", \"com.spotify.music\".",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchTerms": {
                        "title": "Search terms (search mode)",
                        "type": "array",
                        "description": "Keywords to check app rankings for (ASO). Returns the ranked apps per term and country.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "platform": {
                        "title": "Platform",
                        "enum": [
                            "both",
                            "apple",
                            "google"
                        ],
                        "type": "string",
                        "description": "Which store(s) to use.",
                        "default": "both"
                    },
                    "countries": {
                        "title": "Countries",
                        "type": "array",
                        "description": "Two-letter country codes (e.g. us, gb, de).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "includeReviews": {
                        "title": "Include reviews (reviews mode)",
                        "type": "boolean",
                        "description": "Also scrape reviews, not just app metadata.",
                        "default": true
                    },
                    "maxReviewsPerApp": {
                        "title": "Max reviews per app",
                        "minimum": 0,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Per app, per country. Apple caps at ~500 via RSS; Google Play supports more.",
                        "default": 100
                    },
                    "sort": {
                        "title": "Review sort",
                        "enum": [
                            "newest",
                            "mosthelpful",
                            "rating"
                        ],
                        "type": "string",
                        "description": "Order in which reviews are pulled.",
                        "default": "newest"
                    },
                    "chartType": {
                        "title": "Chart type (charts mode)",
                        "enum": [
                            "topfree",
                            "toppaid",
                            "topgrossing"
                        ],
                        "type": "string",
                        "description": "Which Apple chart to pull.",
                        "default": "topfree"
                    },
                    "appleGenreId": {
                        "title": "Apple genre ID (charts mode, optional)",
                        "type": "integer",
                        "description": "Optional App Store genre/category ID to filter charts (e.g. 6017 = Education, 6013 = Health & Fitness, 6014 = Games). Leave empty for overall."
                    },
                    "limit": {
                        "title": "Limit (charts/search mode)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Max apps to return per chart or per search term/country.",
                        "default": 50
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
