# App Store & Google Play Scraper — Reviews, Apps & Charts (`valev-lab/app-store-scraper`) Actor

Scrape Apple App Store and Google Play in one Actor: reviews with developer replies, app details with rating histograms and developer emails, keyword search and top charts by country. Monitor mode returns only new reviews; free summaries list top complaints. From $0.08 per 1,000 reviews.

- **URL**: https://apify.com/valev-lab/app-store-scraper.md
- **Developed by:** [Daniel Valev](https://apify.com/valev-lab) (community)
- **Categories:** Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.08 / 1,000 review scrapeds

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

## App Store & Google Play Scraper — Reviews, App Data & Top Charts, iOS + Android

App Store & Google Play Scraper is an Apify Actor and API that exports **app reviews, app details, keyword search results and top charts from both the Apple App Store and Google Play** to JSON, CSV or Excel, in one run. Paste app URLs, Apple app IDs or Android package names, pick countries, and get one clean row per review or app, with a review summary per app that lists the most common complaints. Reviews cost **from $0.08 per 1,000**, the lowest price among the Store Actors covering both stores that we compared on 2026-11-12.

| At a glance | |
|---|---|
| Stores | Apple App Store (iPhone, iPad, Mac) and Google Play (Android), in one run |
| Data | Reviews with developer replies, app details, keyword search, top charts, review summaries |
| Input | App Store or Google Play URLs, Apple app IDs, Android package names; countries; language |
| Output | JSON, CSV, Excel, XML or HTML; API, webhooks, Make, Zapier, n8n, MCP |
| Price | $0.10 → $0.08 per 1,000 reviews; errors, duplicates and summaries are free |
| Country coverage | Apple: separate reviews, prices and charts per country. Google Play: reviews per language |
| Depth | Reviews: as many as the store shows (tested past 50,000 for one country). Search: Apple 200, Google Play ~30. Charts: Apple 100, Google Play 200 |
| Access | Public store pages over HTTP: no account, API key, cookie or browser |

### What does App Store & Google Play Scraper do?

**App Store & Google Play Scraper** reads the public store pages anyone can open, over plain HTTP. **No API keys, no developer account, no browser, no paid APIs.**

- **Reviews from both stores**: rating, title, text, reviewer, date, app version (Google Play), helpful votes (Google Play), **developer replies**, language. Newest, most helpful or by rating; filter by stars, date and app version.
- **App details**: rating, number of ratings, **rating histogram 1★–5★**, installs (Google Play), price, in-app purchases, version, update and release dates, size, minimum iOS/Android, content rating, description, what's new, screenshots, icon, similar apps.
- **Developer contacts**: website, support email (Google Play), support page (Apple) and privacy policy URL from the public listing.
- **Search and top charts**: rank, app and developer for any keyword or for top free, paid and grossing charts by country and category.
- **Review summaries**: average rating, rating distribution and reviews per month of what you scraped, plus the **top words and phrases in 1–2 star reviews**, computed locally with no AI bill.
- **Monitor mode**: schedule it and get only the reviews that are new since the last run, per app and country.
- **Pay only for results**: errors, duplicates and summaries are free.

[Run it](https://apify.com/valev-lab/app-store-scraper) with no input to see the three newest US reviews of Spotify on each store.

### Who is it for?

**App review monitoring**

- Get every new 1★ review of your app (or a competitor's) each morning, from both stores, in one dataset
- See whether the developer replied and how fast, with `developerReply.text` and `developerReply.date`
- Track rating trends per month and per country, and catch a bad release by `appVersion` on Google Play

**App store optimization (ASO)**

- See who ranks for "budget tracker" in the US and Bulgaria, on iOS and Android, with rank, rating and installs
- Read top free, paid and grossing charts by category and country
- Compare rating histograms, descriptions, what's-new notes and screenshots with your competitors

**Competitor research and product feedback**

- Pull thousands of reviews of competing apps and read the summary's `negativeKeywords` and `negativePhrases` ("many ads", "bring back…") to see what users complain about
- Compare apps across countries: Apple shows different reviews and charts per country, Google Play per language

**App developer leads**

- Search or read a chart, then get app details with `developerWebsite`, `developerEmail` (Google Play), `privacyPolicyUrl` and `supportUrl`
- Filter by installs, ratings, price and last update to find active developers in a niche

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

1. Open [App Store & Google Play Scraper](https://apify.com/valev-lab/app-store-scraper) on Apify (a free account is enough to try it).
2. Keep **What to scrape** on **Reviews**.
3. Paste apps into **Apps**: an App Store URL, an Apple ID such as `324684580`, a Google Play URL, or a package name such as `com.spotify.music`. Mix both stores.
4. Add **Countries** (`us`, `gb`, `bg`…) and set **Max reviews per app and country** (500 by default, 0 for all).
5. Optional: sort, star range, date, app version, monitor mode.
6. Click **Start**, then open the **Reviews** or **Review summaries** view, or download JSON, CSV or Excel.

### Ready-made inputs

Copy one into the **JSON** tab of the input form and press **Start**. Costs use the Free plan prices below.

**New 1–2★ reviews of your app on both stores, every day** — schedule it daily (~$0.01 for 100 new reviews):

```json
{ "mode": "reviews", "apps": ["com.spotify.music", "324684580"], "countries": ["us", "gb"], "maxRating": 2, "monitorMode": true, "maxReviewsPerApp": 1000 }
```

**Bulgarian reviews of a Bulgarian app** — Apple's BG store and Google Play in Bulgarian:

```json
{ "mode": "reviews", "apps": ["bg.dskbank.DSKmobile", "6468069532"], "countries": ["bg"], "maxReviewsPerApp": 500 }
```

**Competitor app details with developer contacts** (5 apps, ~$0.007):

```json
{ "mode": "appDetails", "apps": ["https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "310633997", "com.monefy.app.lite", "https://play.google.com/store/apps/details?id=bg.dskbank.DSKmobile", "id6468069532"], "countries": ["us"] }
```

**Who ranks for a keyword on iOS and Android** (~$0.05 for about 80 results):

```json
{ "mode": "search", "queries": ["budget tracker"], "store": "both", "countries": ["us"], "maxResults": 50 }
```

**Top free apps in the US and Bulgaria on both stores** (400 entries, $0.24):

```json
{ "mode": "topCharts", "chart": "topFree", "category": "all", "store": "both", "countries": ["us", "bg"], "maxResults": 100 }
```

### Input

| Field | What it does |
|---|---|
| `mode` | `reviews`, `appDetails`, `search` or `topCharts` |
| `apps` | App Store/Google Play URLs, Apple numeric IDs (`324684580`, `id324684580`) or Android package names (`com.spotify.music`); the store is detected per app |
| `queries` | Search keywords (search mode) |
| `store` | `apple`, `google` or `both` (search and top charts) |
| `countries` | Two-letter codes, several at once (default `us`) |
| `language` | Google Play language (`en`, `bg`, `pt-BR`…); empty = each country's main language |
| `maxReviewsPerApp` | Reviews per app and country (default 500; 0 = all available) |
| `sort` | `newest`, `mostHelpful` or `rating` (highest first) |
| `minRating` / `maxRating` | Star range, 1–5 |
| `dateFrom` | Only reviews written on or after this date |
| `appVersion` | Only reviews of versions starting with this (Google Play only) |
| `maxResults` | Apps per keyword or chart, per store and country (default 50, max 200) |
| `chart` | `topFree`, `topPaid` or `topGrossing` |
| `category` | `all`, `games`, `finance`, `social`, `productivity` and 17 more, mapped to both stores |
| `includeDeveloperContacts` | Website, email, support and privacy URLs in app details (default on, no extra charge) |
| `monitorMode` | Only reviews earlier runs didn't return |

Proxies are handled for you: every run uses Apify Proxy, so there is nothing to configure.

The full example input is in [`examples/input.json`](examples/input.json).

### What data do you get?

Every row has a `type`. Use the dataset views **Reviews**, **Apps**, **Search & charts** and **Review summaries**, or filter by `type` in your own code. Missing values are `null`; nothing is guessed.

| `type` | Fields |
|---|---|
| `review` | `store`, `appId`, `appName`, `country`, `reviewId`, `rating`, `title`, `text`, `userName`, `date` (ISO), `appVersion`, `thumbsUp`, `developerReply` {`text`, `date`}, `language`, `isEdited`, `isNew`, `reviewUrl`, `scrapedAt` |
| `app` | `store`, `appId`, `bundleId` / `packageName`, `name`, `url`, `developer`, `developerId`, `developerWebsite`, `developerEmail`, `privacyPolicyUrl`, `supportUrl`, `category`, `price`, `currency`, `isFree`, `inAppPurchases`, `inAppPurchasesRange`, `containsAds`, `rating`, `ratingCount`, `reviewCount`, `ratingHistogram` {1…5}, `installs`, `minInstalls`, `version`, `updatedAt`, `releasedAt`, `size`, `minOsVersion`, `contentRating`, `summary`, `description`, `whatsNew`, `screenshots`, `icon`, `similarApps`, `country` |
| `searchResult` / `chartEntry` | `rank`, `query` or `chart` + `chartCategory`, `store`, `appId`, `name`, `url`, `developer`, `icon`, `category`, `rating`, `ratingCount`, `price`, `currency`, `isFree`, `installs`, `description`, `country` |
| `summary` | `store`, `appId`, `appName`, `country`, `reviewCount`, `avgRating`, `ratingDistribution`, `reviewsPerMonth`, `developerReplyRate`, `negativeReviewCount`, `negativeKeywords`, `negativePhrases`, `firstReviewDate`, `lastReviewDate` |
| `error` | `store`, `appId` or `query`, `country`, `errorCode` (`NOT_FOUND`, `NOT_AVAILABLE_IN_COUNTRY`, `INVALID_APP`, `BLOCKED`, `FAILED`, `PARSE_FAILED`), `message` |

Which store fills which field: `appVersion`, `thumbsUp`, `installs`, `developerEmail` and `containsAds` come from **Google Play only**; `title`, `isEdited`, `size` and `supportUrl` from **Apple only**. `language` is detected from the review text (ISO 639-3, such as `eng` or `bul`) and is `null` for very short reviews.

#### Output examples

From local test runs on 2026-11-12 (long text shortened).

A Google Play review with a developer reply:

```json
{
  "type": "review",
  "store": "google",
  "appId": "bg.dskbank.DSKmobile",
  "appName": "DSK Mobile",
  "country": "bg",
  "language": "bul",
  "reviewId": "1efdb5ec-4800-431d-a9aa-cd9e948f538c",
  "rating": 1,
  "title": null,
  "text": "Що за мслоумщина? Прехвърлям се на нов телефон, активирам без проблем приложението…",
  "userName": "Iv. N.",
  "date": "2026-11-10T16:34:15.000Z",
  "appVersion": "5.5.76",
  "thumbsUp": 36,
  "developerReply": { "text": "Съжаляваме за затруднението, което си срещнал…", "date": "2026-03-02T14:34:30.000Z" },
  "isEdited": null,
  "isNew": null,
  "reviewUrl": "https://play.google.com/store/apps/details?id=bg.dskbank.DSKmobile&reviewId=1efdb5ec-4800-431d-a9aa-cd9e948f538c",
  "scrapedAt": "2026-11-12T15:34:21.464Z"
}
```

An App Store app (Apple lists no developer email publicly, so it is `null`):

```json
{
  "type": "app",
  "store": "apple",
  "appId": "324684580",
  "bundleId": "com.spotify.client",
  "name": "Spotify: Music and Podcasts",
  "url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
  "developer": "Spotify",
  "developerId": "324684583",
  "developerWebsite": "https://www.spotify.com/",
  "developerEmail": null,
  "privacyPolicyUrl": "http://www.spotify.com/legal/privacy-policy/",
  "supportUrl": "https://support.spotify.com/",
  "category": "Music",
  "price": 0,
  "currency": "USD",
  "isFree": true,
  "rating": 4.76925,
  "ratingCount": 43076216,
  "ratingHistogram": { "1": 961412, "2": 382119, "3": 963356, "4": 3023263, "5": 37750201 },
  "version": "9.1.98",
  "updatedAt": "2026-11-09T18:28:38.000Z",
  "releasedAt": "2011-07-14T11:22:37.000Z",
  "size": 329352192,
  "minOsVersion": "16.1",
  "contentRating": "12+",
  "similarApps": [{ "appId": "912390687", "name": null, "url": "https://apps.apple.com/us/app/id912390687" }],
  "country": "us",
  "complete": true
}
```

A Google Play app with developer contacts:

```json
{
  "type": "app",
  "store": "google",
  "appId": "com.monefy.app.lite",
  "packageName": "com.monefy.app.lite",
  "name": "Monefy: Money & Budget App",
  "developer": "Reflective Technologies",
  "developerWebsite": "https://monefy.com",
  "developerEmail": "support@monefy.com",
  "privacyPolicyUrl": "https://monefy.com/privacy-policy",
  "category": "Finance",
  "inAppPurchases": true,
  "inAppPurchasesRange": "$2.49 - $59.99 per item",
  "containsAds": false,
  "rating": 3.9784946,
  "ratingCount": 194820,
  "reviewCount": 2606,
  "ratingHistogram": { "1": 30698, "2": 9774, "3": 7654, "4": 31414, "5": 115195 },
  "installs": "10,000,000+",
  "version": "1.22.11",
  "minOsVersion": "6.0",
  "similarApps": [{ "appId": "com.komorebi.kakeibo", "name": "MoneyNote: Expense & Budget", "url": "https://play.google.com/store/apps/details?id=com.komorebi.kakeibo" }]
}
```

A review summary (1,000 newest US Google Play reviews of Spotify):

```json
{
  "type": "summary",
  "store": "google",
  "appName": "Spotify: Music and Podcasts",
  "country": "us",
  "reviewCount": 1000,
  "avgRating": 3.69,
  "ratingDistribution": { "1": 230, "2": 62, "3": 62, "4": 79, "5": 567 },
  "reviewsPerMonth": { "2026-11": 1000 },
  "developerReplyRate": 0.12,
  "negativeReviewCount": 292,
  "negativeKeywords": [{ "keyword": "premium", "count": 66 }, { "keyword": "ads", "count": 62 }, { "keyword": "songs", "count": 48 }],
  "negativePhrases": [{ "phrase": "many ads", "count": 13 }, { "phrase": "sound capsule", "count": 6 }, { "phrase": "bring back", "count": 5 }]
}
```

### Review summaries

After each app and country, the Actor adds one free `summary` row about the reviews it just saved: average stars, the 1★–5★ split, reviews per month, the share with a developer reply, and the most common words and two-word phrases in 1–2 star reviews. Words are counted once per review, common words in English, Bulgarian, German, Spanish, French, Italian and Portuguese, and the app's own name, are ignored, and phrases need at least two reviews. Everything is computed in the run; no AI service sees your data. In monitor mode the summary covers only that run's new reviews.

### How much does it cost?

**Pay per event.** You pay for what you get:

| Event | Free | Bronze | Silver | Gold, Platinum, Diamond |
|---|---:|---:|---:|---:|
| Review (`review-scraped`), per 1,000 | **$0.10** | $0.09 | $0.085 | **$0.08** |
| App details incl. developer contacts (`app-details`), per 1,000 | **$1.20** | $1.00 | $0.90 | **$0.80** |
| Search result or chart entry (`search-or-chart-result`), per 1,000 | **$0.60** | $0.50 | $0.45 | **$0.40** |
| Run start (`apify-actor-start`) | $0.001 | $0.001 | $0.001 | $0.001 |

For example: 1,000 reviews of one app on both stores (2,000 reviews) cost **$0.20** on the Free plan; details of 100 apps cost **$0.12**; the top 100 free apps in two countries on both stores cost **$0.24**. Each run adds $0.001.

**Not charged:** error rows (app not found, not sold in a country, blocked), duplicate reviews, reviews monitor mode already returned, reviews removed by your filters, review summaries, and app rows the Actor could only read in part (`complete: false`). The Actor stops cleanly at your **maximum total charge**.

#### Compared with other App Store and Google Play Actors

Prices per 1,000 results from the Apify Store on 2026-11-12, Free plan → Gold plan. Some Actors go lower on Platinum and Diamond. What each result contains differs, so compare the output as well as the price.

| Actor | Stores | Reviews | App details | Search / charts | Per run |
|---|---|---:|---:|---:|---:|
| **This Actor** | **Apple + Google Play** | **$0.10 → $0.08** | **$1.20 → $0.80** | **$0.60 → $0.40** | $0.001 |
| cleanscrape/app-store-reviews-scraper | Apple + Google Play reviews | $0.20 → $0.16 | — | — | $0.002 |
| code-node-tools/app-reviews-scraper | Apple + Google Play reviews | $0.50 → $0.30 | — | — | $0.00005 |
| brilliant_gum/google-play-app-store-scraper | Apple + Google Play | $6.00 | $10.00 | $4.00 | $0.001 |
| wulfcare/app-store-scraper | Apple | $0.10 | $0.50 | $0.20 | — |
| theagents/appstore-reviews | Apple reviews | $0.10 | — | — | — |
| thequietstack/google-play-reviews | Google Play reviews | $0.09 → $0.063 | — | — | $0.00005 |
| thewolves/appstore-reviews-scraper | Apple reviews | $0.10 | — | — | — |
| thewolves/google-play-reviews-scraper | Google Play reviews | $0.10 | — | — | — |
| neatrat/google-play-store-reviews-scraper | Google Play reviews | $0.15 → $0.10 | — | — | — |
| automation-lab/google-play-scraper | Google Play | $0.11 → $0.088 | $0.70 → $0.56 | — | $0.001 |
| automation-lab/apple-app-store-reviews-scraper | Apple reviews | $0.17 → $0.09 | — | — | $0.005 |
| automation-lab/apple-app-store-scraper | Apple | $1.15 → $0.60 | $3.45 → $1.80 | — | $0.005 |
| johnvc/apple-app-store-reviews-api | Apple reviews | $0.90 → $0.60 | — | — | $0.0175 |
| johnvc/apple-app-store-search | Apple search | — | — | $3.00 → $1.00 | $0.005 |
| johnvc/apple-app-store-product-api | Apple | — | $0.08 → $0.06 | — | $0.0001 |

Among the Actors that cover both stores, this one has the lowest review price on every plan. Single-store Actors are close: thequietstack (Google Play only) is lower on Gold, automation-lab's Apple reviews Actor on Platinum and Diamond, and wulfcare (Apple only) is lower for app details and search. This Actor adds developer contacts, review summaries and monitor mode, with one input and one output format for both stores.

### Monitor mode: only new reviews

Turn on **Monitor mode** and schedule the Actor (daily, hourly). Each run reads reviews newest first and saves only those earlier runs didn't return, with `isNew: true`; already-seen reviews are skipped and never charged again. The run stops as soon as it reaches reviews older than what earlier runs covered.

Memory is kept per app, country (and, on Google Play, language) in the named key-value store `app-store-scraper-monitor` in your account. Monitor mode always reads newest first. If one run hits **Max reviews per app** before it gets back to what the previous run saw, the reviews in between are skipped for good, so give monitors a comfortable limit (for example 1,000).

### Use it from code, Make, Zapier or an AI agent

**JavaScript**

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('valev-lab/app-store-scraper').call({
    mode: 'reviews',
    apps: ['com.spotify.music', '324684580'],
    countries: ['us'],
    maxReviewsPerApp: 200,
    maxRating: 2,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.filter((item) => item.type === 'review').length);
```

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("valev-lab/app-store-scraper").call(run_input={
    "mode": "topCharts", "chart": "topGrossing", "category": "games", "countries": ["us", "de"], "maxResults": 50,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["type"] == "chartEntry":
        print(row["store"], row["country"], row["rank"], row["name"])
```

**MCP** — add the Actor to your Apify MCP server and ask your assistant for "the newest one-star reviews of Spotify on iOS and Android". The **API** tab in Console has the OpenAPI definition.

Every run also writes **`RUN_SUMMARY`** to its key-value store: rows saved and charged per event, success rate per app, requests, blocks and bytes per store, and per-target counts.

### FAQ

#### How many reviews can I get per app, and why does the country matter?

**Apple** keeps separate reviews for every country's App Store: the US store and the Bulgarian store show different reviews of the same app. The Actor reads them 20 at a time and in our test went past the 50,000th review of Spotify's US store, so the practical limit is your **Max reviews per app and country** (0 = all). An app with no reviews in a country returns none there, and an app not sold in a country returns a free `NOT_AVAILABLE_IN_COUNTRY` row. Apple's old customer-reviews RSS feed stopped at 500 reviews per country; it now returns no reviews at all, and this Actor doesn't use it.

**Google Play** groups reviews by **language**, not by country: the US and UK stores return the same English reviews. The Actor picks each country's main language (Bulgarian for `bg`, German for `de`) or the **Language** you set, and skips a second country with the same language instead of fetching duplicates. It reads 200 reviews per request and pages as deep as Google Play allows.

`maxReviewsPerApp` applies to each app in each country (Apple) or language (Google Play).

#### Is there an official App Store or Google Play reviews API?

Only for apps you own. Apple's App Store Connect API returns customer reviews of your own apps, and the Google Play Developer API returns reviews of your own apps from the last week. Neither covers competitors' apps, other countries' stores in bulk, top charts or search results. This Actor works for any public app and gives you an API through Apify: start a run with a POST request and read the results as JSON.

#### How do I export App Store or Google Play reviews to CSV or Excel?

Run the Actor in reviews mode, open the **Reviews** view of the dataset and click **Export** for CSV, Excel, JSON, XML or HTML. To keep a sheet up to date, schedule the Actor with **Monitor mode** on and connect Apify's Google Sheets integration, Make, Zapier or n8n.

#### How do I get Google Play reviews in other languages, or in all languages?

Google Play shows reviews by language. Add the countries whose languages you want (for example `de`, `fr`, `bg`) or set **Language** directly; each language is fetched once. For an app with an international audience, run it with several countries to cover the main languages; every review keeps its `language`.

#### How do I get App Store and Google Play top charts by country?

Choose **Top charts**, pick top free, paid or grossing and a category, and list the countries (`us`, `gb`, `in`, `bg`…). You get one ranked row per app, store and country, so you can compare the US and UK charts, or iOS and Android, in one table.

#### Can I use it from Python or Node.js instead of an open-source scraper library?

Yes. Call it with the `apify-client` package for Python or JavaScript (see the examples above) and you get the same JSON every time. The store-specific parsing runs on Apify and is maintained there: when a store changes, your code doesn't. For example, Apple's customer-reviews RSS feed, which many tools relied on, now returns no reviews; this Actor reads Apple's current web endpoint instead.

#### Can I get the app version of Apple reviews?

No. Apple's public reviews show no version, so `appVersion` is `null` for Apple and the **App version** filter applies to Google Play only. Google Play gives the version of most reviews (about 80% in our tests).

#### Why are there only about 30 Google Play search results?

Google Play's website shows one page of about 30 apps per search and loads no more. Apple's search returns up to 200. Search with several related keywords to cover more apps; each app is listed once per keyword.

#### How deep do the top charts go?

Apple's charts list up to 100 apps per chart, category and country; Google Play's up to 200 (fewer when the chart is shorter, such as top paid). On Google Play, the **All** category means apps without games; choose **Games** for game charts.

#### Does it translate reviews?

No. Reviews come in the language people wrote them in, and `language` tells you which it is. No translation or AI service is used.

#### Which developer contacts are included?

What the public listing shows: on Google Play the developer's website, support email and privacy policy; on Apple the website, support page and privacy policy. Apple doesn't publish developer email addresses, so `developerEmail` is `null` for Apple apps.

#### Do I need an App Store or Google Play account?

No. The Actor reads public store pages only; no account, cookie or API key is used.

#### How fast is it?

Measured on Apify on 2026-11-12: 1,000 Spotify reviews (500 per store) in about 17 seconds, the five newest reviews per store in under 3 seconds, 5 apps with details in about 2 seconds, and 20 chart entries in under 3 seconds.

#### What happens when a store blocks a request?

The request is retried up to four times with growing waits, each time from a new proxy IP. If an app still fails, you get a free `error` row and the run continues with the other apps; the run itself fails only when every app fails. In our cloud tests one request in about 90 was rate-limited, and the retry succeeded.

### Responsible use

The Actor reads public store listings and reviews only. Reviews contain reviewers' public display names; treat them as personal data where data-protection law applies, and use developer contacts in line with anti-spam rules. Respect the stores' terms.

**Disclaimer:** This Actor is not affiliated with, endorsed by, or sponsored by Apple Inc. or Google LLC. App Store is a trademark of Apple Inc.; Google Play is a trademark of Google LLC.

### Support

Open an issue on the **Issues** tab with the run ID and the input that went wrong.

### Changelog

#### 1.0.0

- Reviews, app details, search and top charts for the Apple App Store and Google Play, review summaries, monitor mode, pay per result

# Actor input Schema

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

Reviews of the apps below, their store listings (app details), a keyword search, or a top chart.

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

For reviews and app details. App Store URL (apps.apple.com/…/id324684580), Apple numeric ID (324684580), Google Play URL, or Android package name (com.spotify.music). Mix both stores freely. An iOS bundle ID looks like a package name, so give Apple apps by URL or numeric ID.

## `queries` (type: `array`):

For search mode. Each keyword is searched in every country below, on the stores you pick.

## `store` (type: `string`):

Which store to search or read charts from. In reviews and app details mode the store comes from each app.

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

Two-letter country codes such as us, gb, de, bg. Apple shows different reviews, prices and charts per country. Google Play reviews depend on the language instead (see Language).

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

Google Play language code (en, bg, de, pt-BR…). Empty: each country's main language (bg for Bulgaria, de for Germany, en for the US). On Google Play this decides which reviews you get.

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

Most reviews to save for each app in each country. 0 means all the store will show.

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

Order the store returns reviews in. Rating means highest first.

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

Keep reviews with at least this many stars.

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

Keep reviews with at most this many stars. Set both to 1 for one-star reviews only.

## `dateFrom` (type: `string`):

Only reviews written on or after this date.

## `appVersion` (type: `string`):

Only reviews of versions starting with this text, e.g. 9.1 or 9.1.94. Google Play only: Apple does not show the version on reviews.

## `maxResults` (type: `integer`):

Most apps per keyword or chart, per store and country. Store limits: Apple search 200, Apple charts 100, Google Play charts 200, Google Play search about 30.

## `chart` (type: `string`):

Which top chart to read in top charts mode.

## `category` (type: `string`):

All apps, or one category. On Google Play "All" means apps without games; pick Games for game charts.

## `includeDeveloperContacts` (type: `boolean`):

App details mode: the developer's website, support email (Google Play), support page (Apple) and privacy policy URL, as shown on the public store listing. Included in the app-details price.

## `monitorMode` (type: `boolean`):

Save only reviews earlier runs did not return, per app and country. Schedule the Actor for a feed of new reviews. Memory is kept in the named key-value store app-store-scraper-monitor.

## Actor input object example

```json
{
  "mode": "reviews",
  "apps": [
    "com.spotify.music",
    "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
  ],
  "store": "both",
  "countries": [
    "us"
  ],
  "maxReviewsPerApp": 500,
  "sort": "newest",
  "minRating": 1,
  "maxRating": 5,
  "maxResults": 50,
  "chart": "topFree",
  "category": "all",
  "includeDeveloperContacts": true,
  "monitorMode": false
}
```

# Actor output Schema

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

No description

## `apps` (type: `string`):

No description

## `listings` (type: `string`):

No description

## `summaries` (type: `string`):

No description

## `allRows` (type: `string`):

No description

## `runSummary` (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": [
        "com.spotify.music",
        "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("valev-lab/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",
        "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
    ] }

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

```

## MCP server setup

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