# App Store Reviews API (`soilair/app-store-reviews-api`) Actor

Extract recent public Apple App Store customer reviews with ratings, text, app versions, dates, storefronts, and stable review IDs.

- **URL**: https://apify.com/soilair/app-store-reviews-api.md
- **Developed by:** [Salih Can Kurnaz](https://apify.com/soilair) (community)
- **Categories:** Marketing, Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.05 / 1,000 app store review results

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?

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

### App Store Reviews API

Extract **recent public Apple App Store customer reviews** as structured Dataset rows for product research, sentiment analysis, release monitoring, support intelligence, and competitive analysis. The Actor uses Apple's public customer-review feed and requires no browser, proxy, account login, or API key.

This Actor is **not affiliated with Apple**. It reads public review-feed data and does not claim complete historical App Store review coverage.

#### What you get

Rows can include the stable review ID, numeric app ID, storefront country, star rating, review title, review text, application version, update timestamp, review URL, feed page, and source metadata. Reviewer nickname is **disabled by default**. Enable it only when your use case genuinely requires that public field.

#### Input

`apps` accepts numeric App Store IDs or App Store URLs. `countries` controls storefronts. `pagesPerCountry` sets the number of recent feed pages requested per app/storefront. `maxTotalReviews` provides a hard output cap. Optional `ratings`, `publishedAfter`, and `knownReviewIds` filters support targeted or incremental collection.

For incremental monitoring, save `reviewId` values from previous runs and pass them through `knownReviewIds`. This prevents already-known reviews from being emitted again.

#### Pricing

The primary Pay-per-event event is `review-result`. One event corresponds to one review successfully emitted to the Dataset. Empty feed pages, duplicate records, filtered reviews, retries, and known IDs that are suppressed are not `review-result` events. Apify manages the synthetic Actor-start event.

#### Source behavior and limitations

Apple storefront feeds can legitimately return an empty page while another page or storefront contains reviews. The production contract therefore treats deterministic HTTP-200 empty pages as valid source behavior. The Actor focuses on recent public feed coverage, not an unlimited historical archive. Review availability, storefront differences, and pagination behavior remain controlled by Apple.

#### Responsible use

Use review data for lawful analytics, research, monitoring, and product workflows. Respect applicable privacy, data-protection, copyright, and platform requirements. Do not use public reviewer information for harassment, identity resolution, sensitive profiling, or unrelated personal-data enrichment.

#### Output and integration

The output schema links to the default review Dataset plus `SUMMARY` and `REPORT` records. This supports JSON/CSV export, Apify API, MCP, agentic workflows, scheduled monitoring, webhooks, and downstream databases or analytics tools.

#### Reliability

The production candidate was validated across multiple apps, countries, and independent repeated fetches with stable review IDs and complete core-field coverage. The validation establishes the tested public-feed contract but cannot guarantee that every application has reviews in every storefront.

# Actor input Schema

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

Numeric App Store IDs or App Store URLs.

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

Storefront country codes.

## `pagesPerCountry` (type: `integer`):

Recent-feed pages to fetch. Apple feed pages expose up to 50 review entries each.

## `maxTotalReviews` (type: `integer`):

Hard output cap.

## `ratings` (type: `array`):

Optional exact star ratings to retain.

## `publishedAfter` (type: `string`):

Optional ISO-8601 timestamp filter.

## `knownReviewIds` (type: `array`):

Optional IDs to suppress for incremental polling.

## `includeAuthorName` (type: `boolean`):

Disabled by default.

## Actor input object example

```json
{
  "apps": [
    "310633997",
    "389801252",
    "284882215"
  ],
  "countries": [
    "us",
    "gb",
    "de"
  ],
  "pagesPerCountry": 2,
  "maxTotalReviews": 1000,
  "ratings": [],
  "knownReviewIds": [],
  "includeAuthorName": false
}
```

# Actor output Schema

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

Structured result rows written to the default Dataset.

## `summary` (type: `string`):

Run-level extraction, quality, source, and billing metrics.

## `report` (type: `string`):

Human-readable run report.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("soilair/app-store-reviews-api").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("soilair/app-store-reviews-api").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 '{}' |
apify call soilair/app-store-reviews-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,soilair/app-store-reviews-api"
        }
    }
}

```

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/zn839OzoGrHQE9kgJ/builds/e6jVKWvBr3l4grIxX/openapi.json