# Apple App Store & iOS Reviews Scraper API (Apps & Leads) (`yan0lovesha/apple-app-store-scraper`) Actor

Fast pure-HTTP Apple App Store & iOS reviews scraper API. Extract app metadata, multi-country customer reviews, 1-2 star churn pain points, top charts, IAP pricing & publisher domains in <2s (256MB, MCP & Clay ready).

- **URL**: https://apify.com/yan0lovesha/apple-app-store-scraper.md
- **Developed by:** [Ling Yan](https://apify.com/yan0lovesha) (community)
- **Categories:** Lead generation, Automation, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.12 / 1,000 ios app review scraped ($0.20/1k)s

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

## Apple App Store & iOS Reviews Scraper API (Apps, Top Charts & B2B Leads)

Extract **Apple App Store iOS & macOS app profiles**, **bulk customer reviews (up to 500/app per country)**, **In-App Purchases & subscription pricing tiers**, **App Privacy nutrition labels**, **multi-country Top Charts**, **clean B2B developer root domains (`notion.so`, `linear.app`, `figma.com`)**, and **1–2★ competitor churn pain-point dossiers** in **under 2 seconds**.

Engineered on a **100% pure-HTTP architecture** (`256 MB` RAM, zero headless browser overhead, zero proxy configuration required, `LIMITED_PERMISSIONS` native) for **mobile growth & ASO teams**, **B2B SaaS / SDK outbound teams (Clay, n8n, Make)**, **competitor churn hijacking**, and **MCP / x402 AI Agents**.

***

### Why Growth, ASO & B2B Outbound Teams Switch to This App Store Scraper

| Capability | Legacy App Store Scrapers | This Actor (`apple-app-store-scraper`) |
| :--- | :---: | :---: |
| **Execution Speed & RAM** | 25–90s (`2–4 GB` browser containers) | **< 2 seconds (`256 MB` pure HTTP)** |
| **4-in-1 Unified Modes** | Separate actors for Apps vs. Reviews vs. Charts | **`apps_and_reviews`**, **`reviews_only`**, **`apps_only`**, and **`top_charts`** in one API |
| **Input Flexibility** | Rigid numeric IDs or URLs only | **`apps.apple.com` URLs**, **numeric `trackId`s**, **iOS `bundleId`s (`notion.id`)**, & **Search Keywords** |
| **Live Storefront Enrichment** | Missing from standard iTunes Lookup JSON | Extracts **`inAppPurchases` tiers**, **`supportUrl`**, **`privacyPolicyUrl`**, **`privacyTypes`**, & **1–5★ histogram** |
| **1–2★ Competitor Churn Mining** | Dumps uncategorized reviews | Filters by `minRating`/`maxRating` (e.g. `maxRating: 2`) + tags **6 churn pain-point themes** |
| **B2B Developer Lead Enrichment** | Raw legal entity strings only | Extracts clean **`publisherDomain`**, **monetization model**, **churn score (`0–100`)** & **SDR outreach hook** |
| **Pay-Per-Event Pricing** | `$2.50 – $5.00 / 1,000 items` | **`$0.20 / 1,000 reviews`** (`$0.0002/review`) & **`$0.80 / 1,000 apps`** (`$0.0008/app`) — zero charge for filtered-out ratings |

***

### 4 Seamless Scraping Modes

1. **`apps_and_reviews` _(Default)_** — Scrapes full iOS app metadata + live storefront In-App Purchases, support/privacy links, developer root domain, 1–5★ rating histogram, churn risk score (`0–100`), and embeds matching reviews in `recentReviewsSample` (or set `emitIndividualReviews: true` to also emit flat review rows).
2. **`reviews_only` _(Bulk Sentiment & Competitor Churn Hijacking)_** — Outputs clean, flat `recordType: "review"` rows (`1 row = 1 review`, up to `500` reviews per app per country across pages `1..10`). Pair with `"maxRating": 2` to harvest **only angry 1–2★ user reviews** from competitor apps!
3. **`apps_only` _(Ultra-Fast B2B App & SDK Lead Enrichment)_** — Skips review pagination to enrich hundreds of iOS apps with `publisherDomain`, `monetizationModel` (`FREE`, `PAID`, `FREEMIUM_IAP`, `SUBSCRIPTION`), `inAppPurchases`, `supportUrl`, and `privacyTypes` in milliseconds.
4. **`top_charts` _(Multi-Country Market Intelligence)_** — Scrapes Apple's official `topfreeapplications`, `toppaidapplications`, `topgrossingapplications` (or `all_charts`) across any list of ISO-2 storefronts (`["us", "gb", "de", "jp", ...]`), batch-enriching up to 100 ranked apps per chart in a single HTTP lookup.

***

### Quick Start (Zero Configuration Required)

Click **Start** in Apify Console — the pre-filled `appUrlsOrIds` input scrapes **Notion (`id1232780281`)** and **GitHub (`1477376905`)** in the US storefront, complete with live In-App Purchase tiers, publisher root domains, and customer reviews in **~1.5 seconds** (when calling via API with only `searchTerms` or `mode: "top_charts"`, zero default apps are injected).

#### Example 1: App Profiles + Live IAP Pricing + Reviews (`apps_and_reviews`)

```json
{
  "mode": "apps_and_reviews",
  "appUrlsOrIds": [
    "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
    "1477376905",
    "notion.id"
  ],
  "searchTerms": ["expense tracker"],
  "maxAppsPerSearch": 3,
  "countries": ["us"],
  "includeReviews": true,
  "maxReviewsPerApp": 10,
  "enrichStorefrontDetails": true,
  "generatePublisherDossier": false
}
```

#### Example 2: 1–2★ Competitor Churn Hijacking (`reviews_only`)

```json
{
  "mode": "reviews_only",
  "appUrlsOrIds": [
    "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281"
  ],
  "countries": ["us", "gb", "ca"],
  "maxReviewsPerApp": 200,
  "minRating": 1,
  "maxRating": 2,
  "sortBy": "mostrecent",
  "generatePublisherDossier": true
}
```

#### Example 3: Multi-Country Top Grossing iOS Apps (`top_charts`)

```json
{
  "mode": "top_charts",
  "chartType": "topgrossingapplications",
  "maxChartApps": 50,
  "countries": ["us", "gb", "de"],
  "includeReviews": false,
  "enrichStorefrontDetails": true,
  "generatePublisherDossier": true
}
```

***

### Sample Output Records

#### 1. Enriched App Profile (`Dataset` — `recordType: "app"`)

```json
{
  "recordType": "app",
  "trackId": 1232780281,
  "appName": "Notion: Notes, Tasks, AI",
  "subtitle": "Plan, organize, track projects",
  "bundleId": "notion.id",
  "country": "US",
  "matchedSource": "lookup:id",
  "developerName": "Notion Labs, Incorporated",
  "developerId": 1232780280,
  "publisherDomain": "notion.so",
  "developerWebsite": "https://www.notion.so",
  "supportUrl": "https://www.notion.so",
  "privacyPolicyUrl": "https://www.notion.so/Terms-and-Privacy-28ffdd083dc3473e9c2da6ec011b58ac",
  "monetizationModel": "SUBSCRIPTION",
  "price": 0,
  "formattedPrice": "Free",
  "currency": "USD",
  "inAppPurchases": [
    { "name": "Notion – Plus Monthly", "price": "$11.99" },
    { "name": "Notion Business", "price": "$23.99" },
    { "name": "Notion – Plus Yearly", "price": "$119.99" }
  ],
  "privacyTypes": [
    "Data Linked to You",
    "Data Not Linked to You"
  ],
  "averageUserRating": 4.774,
  "userRatingCount": 90753,
  "ratingHistogram": {
    "5": 80884,
    "4": 4943,
    "3": 1619,
    "2": 898,
    "1": 2409
  },
  "estimatedRatingsPerMonth": 822.4,
  "version": "1.7.356",
  "primaryGenreName": "Productivity",
  "churnRiskScore": 29,
  "painPointSummary": {
    "sampledReviewsCount": 10,
    "negativeReviewsCount": 2,
    "negativeReviewSharePct": 20,
    "themeCounts": {
      "crash/stability": 2,
      "login/auth": 0,
      "billing/pricing": 0,
      "sync/performance": 1,
      "support": 0,
      "missing_feature": 0
    },
    "topPainPointThemes": ["crash/stability", "sync/performance"]
  },
  "storefrontUrl": "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281"
}
```

#### 2. Flat Customer Review (`Dataset` — `recordType: "review"`)

```json
{
  "recordType": "review",
  "reviewId": "14808293666",
  "trackId": 1232780281,
  "appName": "Notion: Notes, Tasks, AI",
  "bundleId": "notion.id",
  "country": "US",
  "rating": 1,
  "title": "App won't open",
  "content": "App is not opening since updated. Latest iOS.",
  "authorName": "Sergiolopez94",
  "appVersion": "1.7.355",
  "voteSum": 0,
  "voteCount": 0,
  "updatedAt": "2026-11-19T10:30:14.000Z",
  "painPointThemes": ["crash/stability"],
  "storefrontUrl": "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281"
}
```

#### 3. B2B Publisher Lead & Churn Dossier (`Key-Value Store` -> `PUBLISHER_DOSSIERS`)

```json
{
  "publisherKey": "notion.so",
  "publisherName": "Notion Labs, Incorporated",
  "publisherDomain": "notion.so",
  "developerId": 1232780280,
  "dominantMonetizationModel": "SUBSCRIPTION",
  "totalRatingsAcrossApps": 90753,
  "estimatedMonthlyRatingVelocity": 822.4,
  "weightedAverageRating": 4.77,
  "negativeReviewCount1To2Star": 2,
  "topPainPoints": ["crash/stability", "sync/performance"],
  "churnRiskScore": 29,
  "churnRiskTier": "MODERATE",
  "b2bOutreachHook": "Noticed Notion: Notes, Tasks, AI (90,753 iOS ratings, monetizing via Notion – Plus Monthly ($11.99)) saw 2 recent 1-2★ reviews flagging \"crash/stability\" issues — happy to share a quick teardown on how peer Productivity teams cut \"crash/stability\" churn and protect App Store conversion."
}
```

***

### Transparent Two-Tier Pay-Per-Event (PPE) Pricing

| Event Name | Description | FREE | BRONZE | SILVER | GOLD | PLATINUM / DIAMOND |
| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
| `apify-actor-start` | One-time container start (includes first 5s compute free) | `$0.00005` | `$0.00005` | `$0.00005` | `$0.00005` | `$0.00005` |
| `app-review-scraped` *(Primary)* | iOS App Review Scraped (`recordType: "review"`, `$0.20 / 1,000`) | `$0.0002` | `$0.00018` | `$0.00015` | `$0.00012` | `$0.0001` |
| `app-metadata-scraped` | iOS App Metadata & Developer Enriched (`recordType: "app"`, `$0.80 / 1,000`) | `$0.0008` | `$0.0007` | `$0.0006` | `$0.0005` | `$0.0005` |
| `publisher-dossier-generated` | Optional B2B Publisher Churn Dossier (`default: false`) | `$0.01` | `$0.009` | `$0.008` | `$0.007` | `$0.006` |

- **Zero surprise charges**: `generatePublisherDossier` is **off by default (`false`)**, and filtered-out star ratings or 0-result queries incur `$0.00` item charges.

***

### Plug-and-Play Integrations (MCP, Clay, n8n & AI Agents)

- **Apify Hosted MCP Server**: Connect Claude Desktop, Cursor, VS Code Copilot, or OpenAI Agents directly via `https://mcp.apify.com/?tools=yan0lovesha/apple-app-store-scraper`.
- **Clay.com / Apollo / Outbound Enrichment**: Feed `top_charts` or category keywords -> extract `publisherDomain` (`linear.app`, `figma.com`, `notion.so`) -> enrich mobile VP Engineering / Head of Growth contacts in Clay -> inject `b2bOutreachHook` directly into personalized cold email sequences.
- **x402 Permissionless Agent Billing**: Fully compatible with `LIMITED_PERMISSIONS` autonomous agent runs.

# Actor input Schema

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

Choose 'apps_and_reviews' (enriched app profiles + embedded review samples & pain points), 'reviews_only' (flat 1-row-per-review dataset for bulk sentiment/churn mining), 'apps_only' (ultra-fast app metadata + storefront enrichment without reviews), or 'top_charts' (Apple Top Free / Paid / Grossing charts).

## `appUrlsOrIds` (type: `array`):

Full apps.apple.com URLs ('https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281'), numeric App Store trackIds ('1477376905'), or iOS bundleIds ('notion.id').

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

Optional App Store search keywords (e.g. 'expense tracker', 'crm', 'habit tracker') queried via Apple's official Search API.

## `maxAppsPerSearch` (type: `integer`):

Maximum apps returned per keyword in searchTerms (1-200).

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

Apple App Store chart feed to scrape when mode is 'top_charts' ('topfreeapplications', 'toppaidapplications', 'topgrossingapplications', or 'all_charts').

## `maxChartApps` (type: `integer`):

Number of ranked apps to scrape per Top Chart per country (1-100, enriched via batch Lookup in a single HTTP request).

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

One or more ISO-2 App Store country codes (e.g. \['us'], \['us', 'gb', 'de', 'ca', 'au', 'fr', 'jp']) for multi-country pricing, rank, and localized review scraping.

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

Fetch structured customer reviews via Apple RSS JSON pagination (up to 500 reviews/app/country across pages 1..10).

## `emitIndividualReviews` (type: `boolean`):

When enabled (or automatically when mode = 'reviews_only'), pushes each matching review as its own flat Dataset item (recordType = 'review'). When false in 'apps_and_reviews' mode, reviews are embedded in recentReviewsSample on each app item.

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

Maximum matching customer reviews to collect per app per country (0-500).

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

Sort customer reviews by 'mostrecent' or 'mosthelpful'.

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

Only keep reviews with rating >= minRating (1-5).

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

Only keep reviews with rating <= maxRating. Tip: Set maxRating = 2 to scrape ONLY 1-2★ angry user reviews for competitor churn hijacking!

## `enrichStorefrontDetails` (type: `boolean`):

Fetches apps.apple.com/{country}/app/id{trackId} via pure HTTP to extract In-App Purchases, supportUrl, privacyPolicyUrl, developerWebsite, privacy nutrition labels, and 1-5★ rating histogram.

## `maxTotalItems` (type: `integer`):

Global cap on total dataset records (apps + individual reviews) pushed and billed in a single run.

## `generatePublisherDossier` (type: `boolean`):

Optional add-on (off by default). Generates account-level publisher intelligence dossiers in Key-Value Store record PUBLISHER_DOSSIERS with root publisherDomain, monetization model, 1-2★ pain-point breakdown, churn risk score (0-100), and ready-to-send B2B SDR outreach hook.

## Actor input object example

```json
{
  "mode": "apps_and_reviews",
  "appUrlsOrIds": [
    "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
    "1477376905"
  ],
  "maxAppsPerSearch": 3,
  "chartType": "topfreeapplications",
  "maxChartApps": 25,
  "countries": [
    "us"
  ],
  "includeReviews": true,
  "emitIndividualReviews": false,
  "maxReviewsPerApp": 10,
  "sortBy": "mostrecent",
  "minRating": 1,
  "maxRating": 5,
  "enrichStorefrontDetails": true,
  "maxTotalItems": 500,
  "generatePublisherDossier": false
}
```

# Actor output Schema

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

Normalized dataset records with recordType 'app' (metadata, IAPs, publisher domain, privacy labels, pain-point summary, recent reviews) and/or 'review' (flat customer review records).

## `publisherDossiers` (type: `string`):

Publisher-level rollups with clean root publisherDomain, monetization model, rating velocity, 1-2★ pain-point themes, churn risk score (0-100), and SDR outreach hooks.

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

Execution latency, mode diagnostics, item counts, and PPE charge telemetry.

# 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 = {
    "mode": "apps_and_reviews",
    "appUrlsOrIds": [
        "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
        "1477376905"
    ],
    "maxAppsPerSearch": 3,
    "countries": [
        "us"
    ],
    "includeReviews": true,
    "maxReviewsPerApp": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("yan0lovesha/apple-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 = {
    "mode": "apps_and_reviews",
    "appUrlsOrIds": [
        "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
        "1477376905",
    ],
    "maxAppsPerSearch": 3,
    "countries": ["us"],
    "includeReviews": True,
    "maxReviewsPerApp": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("yan0lovesha/apple-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 '{
  "mode": "apps_and_reviews",
  "appUrlsOrIds": [
    "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
    "1477376905"
  ],
  "maxAppsPerSearch": 3,
  "countries": [
    "us"
  ],
  "includeReviews": true,
  "maxReviewsPerApp": 10
}' |
apify call yan0lovesha/apple-app-store-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,yan0lovesha/apple-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/4cafZ8HlIanhhP8sY/builds/PocbEDA9eueizQGf6/openapi.json
