# App Store Reviews Scraper: iOS Reviews & Ratings (`capable_cauldron/app-store-reviews-scraper`) Actor

Scrape Apple App Store reviews and ratings for any iPhone or iPad app in any country. Paste an App Store link, app id or app name. Get rating, title, text, author, app version and date, plus the app's average rating and rating count.

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

## Pricing

$0.20 / 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.

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 Reviews Scraper collects **Apple App Store reviews and ratings** for any iPhone or iPad app. Paste an App Store link, an app id or just the app's name, pick one or more **countries**, and get every review's stars, title, text, author, app version and date in a spreadsheet-ready dataset. It also reports each app's **average rating** and **rating count** per country. No Apple account, no login.

Product managers, ASO specialists, customer-support leads and app investors use it to track **app reviews** over time, catch bugs after a release, and compare competitors. It runs on the Apify platform, so you can schedule it daily, call it through the API, trigger webhooks, and send results to Google Sheets, Slack, Make, Zapier or n8n.

Click **Try for free**, keep the WhatsApp example or paste your own app, and press **Start**. The Apify free plan's $5 of monthly credit covers about 25,000 reviews.

See a real run in 47 seconds:

[![App Store Reviews Scraper demo video, 47 seconds](https://api.apify.com/v2/key-value-stores/9FGooi7IrKs0P8DcV/records/app-store-reviews-scraper-demo-poster.jpg)](https://api.apify.com/v2/key-value-stores/9FGooi7IrKs0P8DcV/records/app-store-reviews-scraper-demo.mp4)

▶️ [Watch the 47-second demo](https://api.apify.com/v2/key-value-stores/9FGooi7IrKs0P8DcV/records/app-store-reviews-scraper-demo.mp4) (MP4, 22 MB, opens in your browser) · [Transcript](https://api.apify.com/v2/key-value-stores/9FGooi7IrKs0P8DcV/records/app-store-reviews-scraper-demo-transcript.srt)

### What can App Store Reviews Scraper do?

- ⭐ Scrapes **iOS app reviews** with stars, title, full text, author, app version, helpful votes and date (in UTC)
- 🌍 Reads **any App Store country** (us, gb, de, fr, in, jp and about 170 more) in one run, each with its own reviews
- 🔎 Accepts **App Store links, numeric app ids, bundle ids or app names**, so you never have to look an id up
- 📊 Adds **app details** per country: average rating, total ratings, rating for the current version, version, price, genre and release dates
- 🎚️ Filters by **star rating** (complaints only, 5-star only) and by **date**, stopping early so daily monitoring stays cheap
- 🔁 Sorts by **most recent** or **most helpful**
- 🧾 Deduplicates reviews and writes a clear run summary with per-category errors

| Field | Example |
|---|---|
| `rating` | `1` to `5` |
| `title`, `text` | the review's headline and body |
| `author` | the reviewer's App Store nickname |
| `appVersion` | `25.31.74` |
| `reviewedAt` | `2026-11-04T16:15:02Z` |
| `country` | `us` |

### How to scrape App Store reviews

1. Open the Actor and click **Try for free**. Sign up with Google, GitHub or email; no credit card is needed.
2. In **Apps**, paste one or more App Store links, app ids, bundle ids or app names.
3. In **Countries**, list the App Store countries you care about. Each country has separate reviews, so `us` and `gb` give two sets.
4. Set **Max reviews per app per country**, and optionally a star range or a start date under **Filters**.
5. Click **Start**, then download the reviews as CSV, Excel or JSON, or connect an integration.

#### How do I find an app's id?

You usually don't need to: paste the app's name or its App Store link. If you want the id, it is the number after `id` in the App Store link. In `https://apps.apple.com/us/app/whatsapp-messenger/id310633997` the id is `310633997`.

### How much does it cost to scrape App Store reviews?

You pay per review saved to your dataset. App details and the run summary are free.

| Event | Price |
|---|---|
| Review scraped | $0.0002 |

That is $0.20 per 1,000 reviews. Platform compute and proxy usage are included, so the event table is the whole bill.

Worked examples:

- **100 newest reviews of one app in the US** costs **$0.02**.
- **500 reviews in each of 10 countries** for one app is 5,000 reviews and costs **$1.00**.
- **Daily monitoring** of 5 apps in 3 countries with `reviewsSince` set to yesterday costs a few cents a day, because only new reviews are collected and billed.
- **The free plan.** $5 of monthly credit buys about 25,000 reviews.

To cap spending, set **Maximum cost per run** in the run options. The Actor stops cleanly at the cap and keeps every review it already saved.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `apps` | array | — | App Store links, numeric app ids, bundle ids (`net.whatsapp.WhatsApp`) or app names. Names use the top App Store search result. |
| `countries` | array | `["us"]` | Two-letter App Store country codes. Use `gb` for the United Kingdom (`uk` also works). |
| `maxReviewsPerCountry` | integer | 100 | Reviews to collect per app per country, 1 to 500. |
| `sortBy` | string | `mostRecent` | `mostRecent` or `mostHelpful`. |
| `minRating` | integer | 1 | Lowest star rating to keep. |
| `maxRating` | integer | 5 | Highest star rating to keep. |
| `reviewsSince` | string | — | Only keep reviews written on or after this date (`2026-10-01`). |
| `proxyConfiguration` | object | Apify proxy | Proxy settings. The default datacenter proxy is enough. |

```json
{
    "apps": ["https://apps.apple.com/us/app/whatsapp-messenger/id310633997"],
    "countries": ["us", "gb"],
    "maxReviewsPerCountry": 100,
    "sortBy": "mostRecent",
    "minRating": 1,
    "maxRating": 5
}
```

#### Collecting only negative reviews

Set `minRating` to 1 and `maxRating` to 2. The Actor reads the same pages but saves (and bills) only one- and two-star reviews, which is the fastest way to build a bug and complaint list after a release.

### Output

Each review is one row. This illustrative row uses the app and country in the input above. The reviewer, review and metrics are examples; actual values depend on what the App Store returns when you run it.

```json
{
    "appId": "310633997",
    "appName": "WhatsApp Messenger",
    "developer": "WhatsApp Inc.",
    "country": "us",
    "reviewId": "11000000001",
    "rating": 5,
    "title": "Works great",
    "text": "Calls are clear even on bad wifi.",
    "author": "maria_k",
    "authorUrl": "https://itunes.apple.com/us/reviews/id9001",
    "appVersion": "25.31.74",
    "voteSum": 3,
    "voteCount": 4,
    "reviewedAt": "2026-11-04T16:15:02Z",
    "sortBy": "mostRecent",
    "appStoreUrl": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997?uo=4",
    "scrapedAt": "2026-11-05T09:30:12.004Z"
}
```

The dataset has a **Reviews** view (app, country, stars, title, text, author, version, date) and a **Full detail** view. App details for every app and country go to the `OUTPUT` record in the key-value store:

```json
{
    "status": "SUCCESS",
    "apps": [
        {
            "appId": "310633997",
            "country": "us",
            "appName": "WhatsApp Messenger",
            "developer": "WhatsApp Inc.",
            "averageRating": 4.7,
            "ratingCount": 13802567,
            "currentVersion": "25.31.74",
            "genre": "Social Networking",
            "reviewsScraped": 100
        }
    ]
}
```

### Use cases

Start with one of these six prefilled examples:

- [Monitor the newest WhatsApp App Store reviews](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-monitor-new-whatsapp-reviews)
- [Find one- and two-star app complaints](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-find-one-two-star-app-complaints)
- [Compare US and UK App Store feedback](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-compare-us-uk-app-reviews)
- [Research the most helpful iOS app reviews](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-research-helpful-ios-app-reviews)
- [Research five-star customer feedback for an iOS app](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-collect-positive-app-testimonials)
- [Compare reviews of competing messaging apps](https://apify.com/capable_cauldron/app-store-reviews-scraper/examples/asr-compare-messaging-app-feedback)

### API and integrations

The Actor ID is `capable_cauldron/app-store-reviews-scraper`.

JavaScript:

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('capable_cauldron/app-store-reviews-scraper').call({
    apps: ['310633997'],
    countries: ['us', 'gb'],
    maxReviewsPerCountry: 200,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.filter((r) => r.rating <= 2).length, 'negative reviews');
```

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("capable_cauldron/app-store-reviews-scraper").call(
    run_input={"apps": ["Duolingo"], "countries": ["us"], "maxRating": 2}
)
for review in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(review["rating"], review["title"], review["appVersion"])
```

CLI:

```bash
apify call capable_cauldron/app-store-reviews-scraper --input '{"apps":["310633997"],"countries":["us"]}'
```

For monitoring, create a Task with `reviewsSince` set, schedule it daily, and connect it to Slack, Google Sheets, Make, Zapier or n8n from the **Integrations** tab.

### FAQ

#### Is it legal to scrape App Store reviews?

The Actor reads reviews that Apple publishes openly for anyone to view, without logging in. Reviews include reviewer nicknames, which can be personal data under laws such as GDPR, so use them for analysis rather than contacting people, and store only what you need. Apple's terms apply to how you republish review content. If you are unsure about your use case, ask a lawyer.

#### How many reviews can I get per app?

Apple publishes up to 500 reviews per app for each country and sort order. To collect more, add countries (each has its own reviews) or run once with `mostRecent` and once with `mostHelpful`. Every review in the dataset carries its `country`.

#### Does it work for Mac apps or Google Play?

It covers iPhone and iPad apps on the App Store. Mac App Store and Google Play reviews are not included.

#### Why did an app return no reviews in a country?

Either the app is not sold in that country's App Store (the run summary says so), or it has no written reviews there yet. Star ratings without text are not published as reviews by Apple, so `ratingCount` is often much higher than the number of reviews.

#### Can I scrape App Store reviews with Python?

Yes. Use the Python example in the API section, or call the Apify API from any language. The results are plain JSON.

#### How is this different from other App Store review scrapers?

You can paste app names and links instead of looking up ids, scrape many countries in one run, filter by stars and date before you pay, and get each app's rating and rating count per country in the same run.

### Other Actors by capable_cauldron

| Actor | What it does |
|---|---|
| [Company Job Postings Scraper](https://apify.com/capable_cauldron/ats-jobs-scraper) | Open roles and hiring summaries from supported company job boards |
| [Bulk Email Validator](https://apify.com/capable_cauldron/email-validator) | Syntax, mail-routing, disposable-domain and role-inbox checks |
| [Verified Work Email Finder](https://apify.com/capable_cauldron/verified-work-email-finder) | Verified professional emails from LinkedIn URLs or a name and company domain |
| [GTM Account Enrichment](https://apify.com/capable_cauldron/gtm-account-enrichment) | Public company contacts, technologies and hiring signals with an account fit score |
| [Investor Database Search](https://apify.com/capable_cauldron/investor-database-search) | Filter investors by stage, industry and geography and export available partner contacts |
| [LinkedIn Comment Scraper](https://apify.com/capable_cauldron/linkedin-comment-scraper) | LinkedIn comments and replies using your own session cookies |
| [LinkedIn Post Comments Scraper](https://apify.com/capable_cauldron/linkedin-post-comments-scraper) | Comments, replies and reactions on public LinkedIn posts without cookies |
| [LinkedIn Profile Posts & Comments Scraper](https://apify.com/capable_cauldron/linkedin-profile-posts-comments-scraper) | Posts from any LinkedIn profile with up to 50 comments and replies per post, no cookies needed |
| [LinkedIn Profile Posts Scraper](https://apify.com/capable_cauldron/linkedin-profile-posts-scraper) | Public profile posts with 56 enriched fields, including engagement and content metadata |
| [Ad Scraper: Meta, Google, LinkedIn & TikTok](https://apify.com/capable_cauldron/multi-channel-ad-intelligence) | Competitor ads from Meta, Google, LinkedIn and TikTok in one dataset |
| [TikTok Shop USA Scraper](https://apify.com/capable_cauldron/tiktok-shop-usa-scraper) | US product, shop, creator and shoppable-video data from TikTok Shop |
| [Website Contact Scraper](https://apify.com/capable_cauldron/website-contact-scraper) | Public emails, phone numbers and social profile links from company websites |
| [Website Tech Stack Detector](https://apify.com/capable_cauldron/website-tech-stack-detector) | Visible website technologies and the evidence supporting each detection |
| [LinkedIn Post Search Scraper](https://apify.com/capable_cauldron/linkedin-post-search-scraper) | Keyword searches for public LinkedIn posts with text, authors and engagement |

### Support

Found a bug or need a field that isn't here? Open an issue on the Actor's **Issues** tab. Issues are usually answered within 24 hours. Custom work (Google Play reviews, developer replies, sentiment labels, scheduled Slack alerts) is available; describe it in an issue.

# Actor input Schema

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

Apps to get reviews for. Paste an App Store link (https://apps.apple.com/us/app/whatsapp-messenger/id310633997), a numeric app id (310633997), a bundle id (net.whatsapp.WhatsApp) or an app name (the top search result is used).

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

App Store countries to read reviews from, as two-letter codes (us, gb, de, fr, in, jp...). Each country has its own reviews. Use gb for the United Kingdom.

## `maxReviewsPerCountry` (type: `integer`):

Upper bound on reviews for each app in each country. Apple publishes up to 500 per app, country and sort order. Each review is billed.

## `sortBy` (type: `string`):

Newest reviews first, or the reviews other users voted most helpful.

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

Only keep reviews with at least this many stars. Set both to 1 and 2 to collect complaints only.

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

Only keep reviews with at most this many stars.

## `reviewsSince` (type: `string`):

Only keep reviews written on or after this date. With Most recent, the Actor stops paging once it passes the date, which makes daily monitoring cheap.

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

Proxy settings. Apify datacenter proxy is enough; it spreads requests across IPs so Apple's per-minute limits are not hit on large runs.

## Actor input object example

```json
{
  "apps": [
    "https://apps.apple.com/us/app/whatsapp-messenger/id310633997"
  ],
  "countries": [
    "us"
  ],
  "maxReviewsPerCountry": 100,
  "sortBy": "mostRecent",
  "minRating": 1,
  "maxRating": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per review: app, country, stars, title, text, author, app version, votes and date.

## `runSummary` (type: `string`):

Status, per-app details (average rating, rating count, version, price, genre) for each country, and categorised error counters.

# 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/whatsapp-messenger/id310633997"
    ],
    "countries": [
        "us"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("capable_cauldron/app-store-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/whatsapp-messenger/id310633997"],
    "countries": ["us"],
}

# Run the Actor and wait for it to finish
run = client.actor("capable_cauldron/app-store-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/whatsapp-messenger/id310633997"
  ],
  "countries": [
    "us"
  ]
}' |
apify call capable_cauldron/app-store-reviews-scraper --silent --output-dataset

```

## MCP server setup

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