# Apple App Store Scraper — Reviews, Apps, Search & Top Charts (`foxlabs/apple-app-store-scraper`) Actor

Scrape Apple App Store (iOS) app details, multi-country user reviews, keyword search results and Top Charts with no API keys. Extracts ratings, versions, developer websites, In-App Purchase prices, privacy labels and filtered 1-5 star reviews.

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

## Pricing

from $3.00 / 1,000 app store apps

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

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-Apps_%2B_Reviews-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/175_Countries-IAP_%26_Privacy_Labels-2962FF?style=for-the-badge" alt="175 Countries" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## Apple App Store Scraper — Reviews, Apps, Search & Top Charts 🚀

**foXLabs Mobile & SaaS Intelligence Series:** [Google Play Scraper](https://apify.com/foxlabs/google-play-scraper) · [Product Hunt Launch Leads](https://apify.com/foxlabs/producthunt-launch-leads) · [G2 Software Reviews](https://apify.com/foxlabs/g2-reviews-scraper) · [Trustpilot Reviews](https://apify.com/foxlabs/trustpilot-reviews-scraper) · [Shopify Store Data](https://apify.com/foxlabs/shopify-store-data) · [Threads Scraper](https://apify.com/foxlabs/threads-scraper)

🎉 Turn any iOS application, keyword search or Top Chart on the Apple App Store into clean, structured publisher and product intelligence — with **no Apple Developer API keys, no cookies and zero browser overhead**. Extract complete app metadata (ratings, version release notes, bundle IDs, binary sizes, developer websites), web-enriched **In-App Purchase subscription tiers (`inAppPurchases`)**, **App Privacy nutrition labels** and **Privacy Policy URLs**, plus multi-country paginated customer reviews (`1`–`5` star filterable) and batch-enriched Top Charts across **175 App Store storefronts**.

Built for mobile product & ASO teams, B2B SDK/ad-tech lead generation, SaaS pricing analysts, equity researchers and autonomous AI agents.

### 🔍 What is the Apple App Store Scraper — and when should you use it?

Querying a single Apple endpoint leaves major gaps for product, growth and B2B outreach teams:

- Basic app lookup responses omit **In-App Purchase subscription prices** (such as `"ChatGPT Plus: $19.99"` or `"ChatGPT Pro 100: $100.00"`), **App Privacy nutrition labels** (`"Data Linked to You"`, `"Data Used to Track You"`), and **Privacy Policy / Support URLs** published on `apps.apple.com`.
- Basic Top Chart feeds return app titles and summaries **without** star ratings, review counts, version numbers, binary sizes or external `developerWebsite` links.
- Single-country review scrapers stop at Apple's 500-review per-sort ceiling instead of combining `mostrecent` + `mosthelpful` across global storefronts.

This Actor unifies all four capabilities in a single fast run:

- **App Lookup & Web Enrichment** (`apps`) — resolves numeric App IDs (`"310633997"`), reverse-DNS bundle IDs (`"com.openai.chat"`), or `apps.apple.com` URLs across one or multiple `countries`, enriching each app row with `inAppPurchases`, `privacyTypes`, `privacyPolicyUrl` and `supportUrl`.
- **Multi-Country & Dual-Sort Customer Reviews** (`mode: "appsAndReviews"` or `"reviewsOnly"`) — paginates customer reviews across multiple `countries` (`["us", "gb", "de", "ca", "au"]`) and sort orders (`"mostrecent"`, `"mosthelpful"`, or `"both"` deduplicated by `reviewId`), filtered by `minRating`, `maxRating` and `postedAfter`.
- **Keyword App Search** (`searchQueries`) — discovers up to `200` ranked iOS apps per search phrase per country.
- **Batch-Enriched Top Charts** (`chartType`) — extracts `topfreeapplications`, `toppaidapplications` or `topgrossingapplications` (overall or by `genreId`) and automatically enriches every chart rank with full star ratings, review counts, versions and `developerWebsite` URLs.

**Use it when you need:** 1–2 star churn & bug-regression mining on competitor iOS releases; global SaaS/mobile subscription pricing benchmarks (`inAppPurchases`); B2B publisher lead lists from Top Grossing / Top Free charts with verified `developerWebsite` domains; or multi-country ASO localization audits.

**Use something else when:** you need **private App Store Connect telemetry** (installs, proceeds, or retention cohorts visible only to the app's own publisher) or **more than 1,000 written reviews from one single country storefront** (Apple's public unauthenticated review feed exposes up to 500 reviews per sort order per country). For Android apps and Google Play reviews, use [Google Play Scraper](https://apify.com/foxlabs/google-play-scraper).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/apple-app-store-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/apple-app-store-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "apple-app-store-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/apple-app-store-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** This Actor uses pay-per-event pricing and supports agentic micropayments, so autonomous agents can invoke runs and settle usage over **x402 (USDC on Base)** or **Skyfire** as well as standard Apify API tokens. Billing is strictly per delivered `app` or `review` row — diagnostic `status` rows and filtered-out reviews are `$0.00`.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/apple-app-store-scraper` to collect iOS app metadata, In-App Purchase tiers, customer reviews, keyword search results or Top Charts.

Input fields:
- `apps`: array of App IDs ("310633997"), bundle IDs ("com.openai.chat") or apps.apple.com URLs
- `searchQueries`: optional array of App Store search keywords (e.g. ["habit tracker"])
- `chartType`: "none" (default) | "topfreeapplications" | "toppaidapplications" | "topgrossingapplications"
- `genreId`: optional numeric Apple category ID (e.g. "6015" Finance, "6007" Productivity)
- `countries`: array of 2-letter ISO storefront codes (default ["us"]; e.g. ["us", "gb", "ca"])
- `mode`: "appsAndReviews" (default) | "reviewsOnly" | "appsOnly"
- `reviewSort`: "mostrecent" (default) | "mosthelpful" | "both"
- `maxReviewsPerApp`: integer 1..2000 (default 50)
- `minRating` / `maxRating`: integer 1..5 star filters
- `postedAfter`: optional ISO date YYYY-MM-DD
- `maxResults`: overall row cap across the run (default 100; 0 = unlimited)

Start with:
{"apps":["310633997","com.openai.chat"],"countries":["us"],"mode":"appsAndReviews","maxReviewsPerApp":15,"maxResults":35}
```

**Things you can ask your AI agent:**

- *"Compare ChatGPT, Claude and Perplexity on the US and UK iOS App Stores — extract their In-App Purchase price tiers and summarize 1–2 star complaints from the past 30 days."*
- *"Pull the Top 25 Grossing Finance apps (`genreId: '6015'`) in the US with their ratings, release dates and developer websites."*
- *"Search the iOS App Store for 'calorie tracker', collect the top 20 apps and list which ones charge $9.99+/month via In-App Purchases."*

The machine-readable Actor summary, MCP metadata and OpenAPI schema live at `https://apify.com/foxlabs/apple-app-store-scraper.md`.

### 📋 Overview

Everything needed to turn iOS App Store listings, user reviews, keyword rankings and Top Charts into clean tabular or JSON records across 175 countries — with zero Apple credentials.

| Property | Details |
|---|---|
| **Public data sources** | Public Apple App Store metadata, customer review feeds, Top Charts & `apps.apple.com` product pages |
| **Authentication required** | None — zero Apple Developer keys, App Store Connect tokens or cookies |
| **Storefront coverage** | 175 two-letter ISO country storefronts (`us`, `gb`, `de`, `fr`, `jp`, `kr`, `br`, `tr`, `au`, `ca`, etc.) |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (fast startup, minimal compute cost) |
| **Output row types (`rowType`)** | `app` (`$0.0030`), `review` (`$0.0008`), `status` (`$0.00` diagnostic rows) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`app:<country>:<appId>`, `review:<reviewId>`) — zero duplicate rows or double charges |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`/apps`, `/reviews`, `/search`, `/charts`) |

**Why teams pick this Actor:**

- 💳 **In-App Purchase pricing unlocked** — captures subscription & coin price tiers (`inAppPurchases`) that standard iTunes API scrapers miss completely.
- 🔒 **App Privacy & compliance links** — extracts `privacyTypes` nutrition labels (`"Data Linked to You"`, `"Data Used to Track You"`), `privacyPolicyUrl` and `supportUrl` for enterprise vendor & SDK due diligence.
- 🌍 **175-country multi-storefront runs** — compare localized pricing, ratings and written user reviews across US, EU, UK, APAC and LATAM in a single job.
- 🏆 **Fully enriched Top Charts** — every chart entry carries `chartRank` (`1..100`) **plus** `rating`, `ratingsCount`, `version`, `fileSizeMb` and `developerWebsite`.
- 💰 **Fair pay-per-event pricing** — `$0.0030` per enriched app and `$0.0008` per review; filtered-out reviews and invalid-ID `status` rows cost `$0.00`.

### ✨ Key Features

- 🆔 **Universal App Identifier Resolution** — Mix numeric App IDs (`310633997`), `id`-prefixed IDs (`id6448311069`), reverse-DNS bundle IDs (`com.openai.chat`) and full regional `apps.apple.com` URLs in the same `apps` list.
- 💰 **Subscription & In-App Purchase Extraction (`enrichWebDetails: true`)** — Parses `inAppPurchases` (`[{ "name": "ChatGPT Plus", "price": "$19.99" }]`), `inAppPurchasesText`, `hasInAppPurchases`, `privacyTypes`, `privacyPolicyUrl` and `supportUrl`.
- ⭐ **Dual-Sort & Star-Filtered Reviews** — Combine `reviewSort: "both"` (`mostrecent` + `mosthelpful` deduplicated by `reviewId`) with `minRating`, `maxRating` (e.g. `1`–`2` stars for bug triage) and `postedAfter` (`YYYY-MM-DD`).
- 🔎 **Keyword ASO Search** — Discover up to `200` ranked apps per keyword per country (`searchQueries` + `maxSearchResults`).
- 📊 **Top Free, Paid & Grossing Charts** — Pull up to `100` ranked apps per storefront and category (`genreId`, e.g. `"6015"` Finance, `"6007"` Productivity) with automatic batch metadata enrichment.
- 📄 **CSV-Ready Companion Columns** — Includes pipe-separated `inAppPurchasesText` and `privacyTypesText` strings alongside structured JSON arrays.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns clean JSON records directly):**

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~apple-app-store-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"apps":["310633997","com.openai.chat"],"countries":["us"],"mode":"appsAndReviews","maxReviewsPerApp":15,"maxResults":35}'
```

**2. Real-time Standby HTTP API (warm container queries):**

```bash
## Enrich apps with IAP tiers & privacy labels on demand
curl "https://foxlabs--apple-app-store-scraper.apify.actor/apps?apps=310633997,com.openai.chat&country=us&token=YOUR_APIFY_TOKEN"

## Fetch Top 25 Free Finance apps in the US
curl "https://foxlabs--apple-app-store-scraper.apify.actor/charts?type=topfreeapplications&genreId=6015&country=us&limit=25&token=YOUR_APIFY_TOKEN"
```

### 🚀 Getting Started (3 steps)

1. **Select your targets** — Enter App IDs, bundle IDs or URLs in **Apps**, ASO keywords in **Search queries**, or pick a **Chart type** (`topfreeapplications`, `toppaidapplications`, `topgrossingapplications`).
2. **Choose storefronts & review filters** — Set **Countries** (e.g. `["us"]` or `["us", "gb", "de"]`), **Mode** (`appsAndReviews`, `reviewsOnly`, `appsOnly`), star filters (`minRating`..`maxRating`) and `postedAfter`.
3. **Run & export** — Click **Start** and download your clean dataset as JSON, CSV, Excel, Parquet or XML.

### 📥 Input & Filters

```json
{
  "apps": ["310633997", "com.openai.chat"],
  "searchQueries": ["habit tracker"],
  "chartType": "topgrossingapplications",
  "genreId": "6015",
  "countries": ["us", "gb"],
  "mode": "appsAndReviews",
  "reviewSort": "mostrecent",
  "maxReviewsPerApp": 50,
  "maxSearchResults": 10,
  "chartLimit": 25,
  "maxResults": 200,
  "minRating": 1,
  "maxRating": 5,
  "postedAfter": "2026-01-01",
  "enrichWebDetails": true
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `apps` | `array<string>` | Prefill `["310633997", "com.openai.chat"]` | Numeric App IDs, reverse-DNS bundle IDs, or `apps.apple.com` URLs. |
| `searchQueries` | `array<string>` | `[]` | Keywords to search on the iOS App Store (`1`–`200` apps per query). |
| `chartType` | `string` | `"none"` | Top Chart feed: `"none"`, `"topfreeapplications"`, `"toppaidapplications"`, or `"topgrossingapplications"`. |
| `genreId` | `string` | `""` | Optional numeric Apple category ID for `chartType` (`"6015"` Finance, `"6007"` Productivity, `"6000"` Business, `"6014"` Games). |
| `countries` | `array<string>` | `["us"]` | Two-letter ISO App Store country codes (`["us", "gb", "de", "jp"]`). |
| `mode` | `string` | `"appsAndReviews"` | Output selection: `"appsAndReviews"`, `"reviewsOnly"`, or `"appsOnly"`. |
| `reviewSort` | `string` | `"mostrecent"` | Review feed order: `"mostrecent"`, `"mosthelpful"`, or `"both"` (deduplicated). |
| `maxReviewsPerApp` | `integer` | `50` | Maximum reviews collected per app per country (`1`–`2000`; prefill `15`). |
| `maxSearchResults` | `integer` | `20` | Maximum apps returned per keyword in `searchQueries` (`1`–`200`). |
| `chartLimit` | `integer` | `25` | Number of ranked chart apps returned when `chartType` is active (`1`–`100`). |
| `maxResults` | `integer` | `100` | Overall cap on delivered rows across the run (`0` = unlimited; prefill `35`). |
| `minRating` / `maxRating` | `integer` | `1` / `5` | Inclusive star-rating bounds (`1`–`5`) applied to customer reviews. |
| `postedAfter` | `string` | `""` | Optional ISO-8601 date cut-off (`YYYY-MM-DD`) applied to customer reviews. |
| `enrichWebDetails` | `boolean` | `true` | Fetch `apps.apple.com` product page to attach `inAppPurchases`, `privacyTypes`, `privacyPolicyUrl` and `supportUrl`. |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via Apify Proxy. |

**Copy-paste input recipes:**

- **1–2 star competitor bug & churn audit across 3 countries (`reviewsOnly`):**
  `{"apps":["com.openai.chat","6473753684"],"countries":["us","gb","ca"],"mode":"reviewsOnly","reviewSort":"both","maxRating":2,"maxReviewsPerApp":200,"maxResults":500}`
- **Top 50 Grossing Productivity publisher leads (`chartType` + `appsOnly`):**
  `{"apps":[],"chartType":"topgrossingapplications","genreId":"6007","chartLimit":50,"countries":["us"],"mode":"appsOnly","maxResults":50}`
- **Global subscription & IAP purchasing-power benchmark (`appsOnly` + `5` countries):**
  `{"apps":["com.openai.chat"],"countries":["us","gb","de","jp","br"],"mode":"appsOnly","enrichWebDetails":true,"maxResults":10}`

### 📤 Output Schema & Real Sample Record

Every row in the Dataset shares `rowKey`, `rowType`, `sourceType`, `input`, `country`, `url` and `scrapedAt`. Unresolvable app IDs or empty inputs produce a free `rowType: "status"` diagnostic row.

#### App rows (`rowType: "app"` — 52 columns)

| Field | Type | Description |
|---|---|---|
| `rowKey` | `string` | Deterministic unique key `app:<country>:<appId>` (or `app:<country>:<chartType>:<appId>`) |
| `appId` / `bundleId` / `appTitle` | `string` | Numeric Apple `trackId`, iOS bundle identifier and app title |
| `chartType` / `chartRank` | `string \| null` / `integer \| null` | Chart feed type and `1..100` position when sourced from Top Charts |
| `developerId` / `developerName` / `sellerName` | `string \| null` | Publisher artist ID, display name and legal seller entity |
| `developerWebsite` / `privacyPolicyUrl` / `supportUrl` | `string \| null` | Publisher external website, privacy policy URL and support URL |
| `price` / `formattedPrice` / `currency` / `isFree` | `number` / `string` / `boolean` | Upfront App Store download price in local storefront currency |
| `hasInAppPurchases` / `inAppPurchases` / `inAppPurchasesText` | `boolean \| null` / `array` / `string` | Structured In-App Purchase tiers (`[{ "name": "ChatGPT Plus", "price": "$19.99" }]`) |
| `privacyTypes` / `privacyTypesText` | `array<string>` / `string` | App Privacy labels (`"Data Linked to You"`, `"Data Not Linked to You"`, `"Data Used to Track You"`) |
| `rating` / `ratingsCount` | `number \| null` / `integer \| null` | Storefront star average (`0..5`) and total rating count |
| `version` / `currentVersionReleaseDate` / `releasedAt` / `releaseNotes` | `string \| null` | Current release version, timestamps and "What's New" notes |
| `minimumOsVersion` / `fileSizeBytes` / `fileSizeMb` / `contentRating` | `string` / `integer` / `number` | Minimum iOS version, binary size in MB and age rating |
| `primaryGenre` / `genres` / `languages` | `string` / `array<string>` | App Store categories and supported ISO-2 language codes |
| `iconUrl` / `screenshotUrls` / `ipadScreenshotUrls` | `string` / `array<string>` | High-resolution icon and iPhone/iPad screenshot URLs |

#### Review rows (`rowType: "review"`)

| Field | Type | Description |
|---|---|---|
| `rowKey` | `string` | Deterministic unique key `review:<reviewId>` |
| `reviewId` / `appId` / `bundleId` / `appTitle` | `string` | Unique Apple review ID and parent app identifiers |
| `country` / `sortBy` | `string` | Storefront ISO-2 code and feed sort (`"mostrecent"` or `"mosthelpful"`) |
| `authorName` / `authorUrl` | `string \| null` | Reviewer display name and public reviewer URI |
| `rating` / `version` | `integer` / `string \| null` | `1`–`5` star score and exact app version reviewed |
| `title` / `text` | `string` | Review headline and full body text |
| `voteSum` / `voteCount` | `integer \| null` | Helpfulness upvotes and total votes cast |
| `publishedAt` | `string \| null` | Exact UTC ISO-8601 review timestamp |

#### Real sample records (from live platform verification `tJbWDDPe8fDJ7PTjP`, 2026-11-14)

```json
{
  "rowKey": "app:us:6448311069",
  "rowType": "app",
  "sourceType": "app_lookup",
  "input": "com.openai.chat",
  "country": "us",
  "chartType": null,
  "chartRank": null,
  "appId": "6448311069",
  "bundleId": "com.openai.chat",
  "appTitle": "ChatGPT",
  "title": "ChatGPT",
  "developerId": "1684349733",
  "developerName": "OpenAI OpCo, LLC",
  "sellerName": "OpenAI OpCo, LLC",
  "developerWebsite": "https://openai.com/chatgpt",
  "privacyPolicyUrl": "https://openai.com/policies/privacy-policy",
  "price": 0,
  "formattedPrice": "Free",
  "currency": "USD",
  "isFree": true,
  "hasInAppPurchases": true,
  "inAppPurchases": [
    { "name": "ChatGPT Plus", "price": "$19.99" },
    { "name": "ChatGPT Go", "price": "$8.00" },
    { "name": "ChatGPT Pro 100", "price": "$100.00" }
  ],
  "inAppPurchasesText": "ChatGPT Plus: $19.99 | ChatGPT Go: $8.00 | ChatGPT Pro 100: $100.00",
  "privacyTypes": ["Data Linked to You"],
  "privacyTypesText": "Data Linked to You",
  "rating": 4.82,
  "ratingsCount": 12167276,
  "version": "1.2026.307",
  "currentVersionReleaseDate": "2026-11-10T17:56:25Z",
  "releasedAt": "2023-05-18T07:00:00Z",
  "minimumOsVersion": "18.0",
  "fileSizeMb": 297.95,
  "primaryGenre": "Productivity",
  "url": "https://apps.apple.com/us/app/chatgpt/id6448311069",
  "scrapedAt": "2026-11-14T05:02:25.310Z"
}
```

```json
{
  "rowKey": "review:14777071898",
  "rowType": "review",
  "sourceType": "app_reviews",
  "input": "com.openai.chat",
  "country": "us",
  "sortBy": "mostrecent",
  "reviewId": "14777071898",
  "appId": "6448311069",
  "bundleId": "com.openai.chat",
  "appTitle": "ChatGPT",
  "authorName": "kgracieg",
  "authorUrl": "https://itunes.apple.com/us/reviews/id33582215",
  "rating": 1,
  "version": "1.2026.307",
  "title": "Standard Voice",
  "text": "Standard voice was the only thing making this app even remotely usable.",
  "voteSum": 0,
  "voteCount": 0,
  "publishedAt": "2026-11-11T10:41:26.000Z",
  "url": "https://apps.apple.com/us/app/id6448311069?see-all=reviews",
  "scrapedAt": "2026-11-14T05:02:26.105Z"
}
```

Every completed run also writes a `SOURCE_REPORT` summary object to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`jk0raju9c11epkwCR`, `JpxYDTtZiASnfN8hg`, `SrX1h7s3e7cEWdOhA`) and live D+0 billing verification (`tJbWDDPe8fDJ7PTjP`, `u2q61yAvnFNojPhwA` on 2026-11-14):

- **100% row uniqueness:** Deduplicated by `app:<country>:<appId>` and `review:<reviewId>`, guaranteeing `0` duplicate reviews even when `reviewSort: "both"` merges `mostrecent` and `mosthelpful` feeds.
- **Complete 52-column publisher & IAP enrichment:** Verified live extraction of localized `inAppPurchases` tiers, `privacyTypes`, `privacyPolicyUrl`, `sellerName` and `developerWebsite` across US and international storefronts.
- **Exact billing alignment:** Live D+0 run `tJbWDDPe8fDJ7PTjP` (`1` app + `4` reviews) settled at `{app: 1, review: 4}`, and empty-input run `u2q61yAvnFNojPhwA` (`1` diagnostic `status` row) settled at `{app: 0, review: 0}`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **Sub-10-second lookups & charts:** Enriched app lookups and Top 25 chart sweeps complete in **3 to 9 seconds** because batch metadata lookups resolve up to 100 chart IDs in a single HTTP request.
- **Low memory footprint:** Runs smoothly inside a `256 MB` container with zero headless browser overhead.
- **Restart-safe deduplication:** Container restarts or server migrations automatically skip any `rowKey` already stored in the run's Dataset.

### 💼 Use Cases

1. **Competitor Churn & 1–2 Star Release Bug Triage (`reviewsOnly` + `maxRating: 2`)**
   - *Input:* `{"apps":["com.openai.chat","6473753684"],"countries":["us","gb","ca"],"mode":"reviewsOnly","reviewSort":"both","maxRating":2,"maxReviewsPerApp":200,"maxResults":500}`
   - *Output:* Deduplicated 1- and 2-star reviews tagged with exact `version` and storefront `country`.
   - *Business action:* Spot broken iOS releases, paywall backlash and UX regressions across English-speaking markets within hours of release.

2. **Top Grossing Publisher B2B Lead Generation (`chartType` + `appsOnly`)**
   - *Input:* `{"apps":[],"chartType":"topgrossingapplications","genreId":"6007","chartLimit":50,"countries":["us"],"mode":"appsOnly","maxResults":50}`
   - *Output:* Top 50 Grossing Productivity iOS apps ranked `1..50` with `sellerName`, `developerWebsite`, `inAppPurchases`, `ratingsCount` and `version`.
   - *Business action:* Build high-intent B2B outreach lists for mobile SDKs, billing platforms, ad networks or localization agencies.

3. **Global Subscription & Purchasing-Power Price Benchmarking (`enrichWebDetails: true`)**
   - *Input:* `{"apps":["com.openai.chat"],"countries":["us","gb","de","jp","br"],"mode":"appsOnly","enrichWebDetails":true,"maxResults":10}`
   - *Output:* One row per storefront showing localized `inAppPurchases` subscription prices in USD, GBP, EUR, JPY and BRL.
   - *Business action:* Benchmark regional subscription tiers and parity pricing across international App Store markets.

4. **Enterprise Vendor & Mobile App Security Vetting (`privacyTypes` + `privacyPolicyUrl`)**
   - *Input:* `{"apps":["com.openai.chat","310633997"],"countries":["us"],"mode":"appsOnly","enrichWebDetails":true,"maxResults":20}`
   - *Output:* `sellerName`, `minimumOsVersion`, `privacyTypes` (`"Data Used to Track You"`, `"Data Linked to You"`), and `privacyPolicyUrl`.
   - *Business action:* Automate IT/GRC compliance checks before approving mobile apps for corporate MDM deployment.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/apple-app-store-scraper').call({
    apps: ['310633997', 'com.openai.chat'],
    countries: ['us'],
    mode: 'appsAndReviews',
    maxReviewsPerApp: 25,
    maxResults: 60,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} App Store rows`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/apple-app-store-scraper").call(
    run_input={
        "apps": ["310633997", "com.openai.chat"],
        "countries": ["us"],
        "mode": "appsAndReviews",
        "maxReviewsPerApp": 25,
        "maxResults": 60,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item["rowType"], item.get("appTitle"), item.get("rating"), item["url"])
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **Automated VoC review alerts (n8n / Make / Zapier):** Schedule daily with `mode: "reviewsOnly"`, `maxRating: 2`, and `postedAfter` set to yesterday → route new 1–2 star reviews straight to #mobile-releases in Slack, Jira or Linear.
- **Clay publisher enrichment:** Hit `https://foxlabs--apple-app-store-scraper.apify.actor/apps?apps={{bundleId}}&country=us` from Clay to enrich mobile app prospect tables with `developerWebsite`, `sellerName`, `ratingsCount` and `inAppPurchasesText`.

### 📊 Pricing (Pay-Per-Event)

Transparent **Pay-Per-Event (PPE)** pricing — no monthly rental fee:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `app` | Once per unique `rowType: "app"` record delivered (IAP, privacy & chart lookup included) | **$0.0030** | **$3.00 / 1,000** |
| `review` | Once per unique `rowType: "review"` customer review delivered | **$0.0008** | **$0.80 / 1,000** |
| `status` *(diagnostic)* | Invalid App ID, unfound storefront app, or zero-match filter note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **Top 100 Grossing apps enriched with websites & IAPs (`appsOnly`):** `100 × $0.0030` = **$0.30**
- **5 competitor apps × (1 app row + 200 reviews each):** `5 × $0.0030 + 1,000 × $0.0008` = **$0.815**
- **2,500 multi-country customer reviews (`reviewsOnly`):** `2,500 × $0.0008` = **$2.00**

**Billing guarantees:**

- **Filtered-out reviews & duplicates are `$0.00`:** Reviews skipped by `minRating`, `maxRating`, or `postedAfter`, duplicate reviews across `reviewSort: "both"`, and `rowType: "status"` rows are never billed.
- **Proxy traffic is included:** Apify Proxy usage is covered inside the per-event price above.
- **Exact spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` checks your remaining budget before pushing each batch and stops cleanly at your cap. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including runs that return zero billable rows.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need an Apple Developer account or App Store Connect API key?

No. All app metadata, In-App Purchase tiers, privacy nutrition labels, keyword search rankings, Top Charts and customer reviews are collected from publicly accessible Apple App Store surfaces on our infrastructure. You never supply Apple Developer keys, JWT tokens, cookies or external proxies.

#### How many reviews can I extract for a single iOS app?

Apple's public unauthenticated customer-review feed exposes up to 10 pages (`50` reviews per page = `500` reviews) per sort order in each country storefront. Setting `reviewSort: "both"` combines `mostrecent` and `mosthelpful` (deduplicated by `reviewId`) for up to ~1,000 unique reviews in one country, and passing multiple storefronts in `countries` (such as `["us", "gb", "ca", "au", "de", "fr"]`) lets you collect several thousand unique reviews for global apps in a single run.

#### Can I look up apps by reverse-DNS `bundleId` as well as numeric App ID?

Yes. The `apps` array accepts bare numeric Apple IDs (`"310633997"`), `id`-prefixed strings (`"id6448311069"`), reverse-DNS bundle identifiers (`"com.openai.chat"`, `"net.whatsapp.WhatsApp"`), and full `https://apps.apple.com/...` URLs interchangeably. For Android package names on Google Play, pair this Actor with [Google Play Scraper](https://apify.com/foxlabs/google-play-scraper).

#### What does `enrichWebDetails` add, and when should I turn it off?

When `enrichWebDetails` is `true` (default), the Actor fetches each emitted app's public `apps.apple.com` storefront page to extract `inAppPurchases` (`{ name, price }` tiers), `hasInAppPurchases`, `privacyTypes` (`"Data Linked to You"`, `"Data Used to Track You"`), `privacyPolicyUrl` and `supportUrl`. If you only need core lookup fields (`rating`, `ratingsCount`, `version`, `sellerName`, `developerWebsite`) across hundreds of apps at maximum speed, set `enrichWebDetails: false`.

#### Why is `inAppPurchases` an empty array on some free iOS apps?

Truly free utility or messaging apps that do not sell subscriptions or consumables through Apple's billing system (for example WhatsApp Messenger) have no In-App Purchases section on their App Store listing; for those apps, `hasInAppPurchases` is `false` and `inAppPurchases` is `[]`. Subscription-monetized apps populate every public price tier displayed on their storefront page.

#### Which `genreId` category codes can I use with `chartType`?

Common Apple App Store `genreId` values include `"6000"` (Business), `"6001"` (Weather), `"6002"` (Utilities), `"6003"` (Travel), `"6004"` (Sports), `"6005"` (Social Networking), `"6007"` (Productivity), `"6008"` (Photo & Video), `"6012"` (Lifestyle), `"6013"` (Health & Fitness), `"6014"` (Games), `"6015"` (Finance), `"6016"` (Entertainment), `"6017"` (Education), `"6018"` (Books), `"6020"` (Medical), and `"6024"` (Shopping). Leave `genreId` blank (`""`) to pull the overall all-categories chart.

#### How do I scrape only Top Charts or only `searchQueries` without the prefilled apps?

In the Apify Console Input form, clear the prefilled `apps` array before clicking Start. When calling via the REST API, Python/Node.js SDK, n8n or MCP, pass `"apps": []` explicitly alongside your `"chartType"` or `"searchQueries"` parameters so the prefilled showcase apps are not included.

#### If I pass a localized URL like `apps.apple.com/gb/app/...`, which country is used?

When `countries` is left at its default `["us"]` and an entry in `apps` is a localized URL carrying an explicit storefront segment (such as `/gb/` or `/de/`), the Actor automatically honors that URL's storefront country. When you explicitly pass multiple storefronts in `countries` (for example `["us", "gb", "de", "jp"]`), the Actor queries the app across every country in your list so you can compare regional prices and ratings side by side.

#### Why are `rating` and `ratingsCount` different from the number of written reviews returned?

On the iOS App Store, users can tap a `1`–`5` star rating without writing a text review; `ratingsCount` reflects all star taps in that country storefront (for example `12,167,276` ratings), whereas the customer review feed returns only submissions where the user also wrote a headline and comment. In addition, `rating` and `ratingsCount` are storefront-specific, so US and UK figures naturally differ.

#### What happens if an app was removed from the App Store or is unavailable in one country?

Many regional banking, media or telecom apps are published only in specific country storefronts. If an app ID returns not-found in one storefront, the Actor writes a free `rowType: "status"` diagnostic note identifying that app and country, charges `$0.00`, and continues collecting all available storefronts and apps in your batch without failing.

#### How can I monitor only new reviews published since my last scheduled run?

Pass `postedAfter` as an ISO date (`"YYYY-MM-DD"`) with `reviewSort: "mostrecent"` and `mode: "reviewsOnly"`. Because `mostrecent` returns reviews newest-first, pagination stops automatically as soon as reviews fall behind your `postedAfter` cut-off, keeping scheduled daily or weekly runs fast and inexpensive.

#### What happens if Apify restarts or migrates my container during a multi-country run?

At startup, the Actor reads all `rowKey` identifiers (`app:<country>:<appId>` and `review:<reviewId>`) already written to the run's default Dataset and skips them automatically, preventing both duplicate rows and duplicate per-event charges.

### 🐛 Troubleshooting

- **Dataset contains only a `rowType: "status"` row with `"Empty input"`:** You passed `"apps": []` without providing `searchQueries` or selecting a `chartType` other than `"none"`. Add at least one target source.
- **Fewer reviews returned than `maxReviewsPerApp`:** Check `maxResults` (default overall cap is `100` — set `maxResults: 0` or raise it when scraping hundreds of reviews), `minRating` / `maxRating`, and `postedAfter`, or check whether the app has fewer written reviews in that storefront.
- **App returned `"not found"` in `"us"`:** The app may be geo-restricted to a regional storefront (e.g. `"gb"`, `"de"`, `"tr"`, `"jp"`). Set `countries` to the target market's two-letter ISO code.
- **Invalid `postedAfter` date:** Use strict `YYYY-MM-DD` format (e.g. `"2026-11-01"`).

### 🚧 What It Does Not Do

- Does **not** access private App Store Connect developer metrics (download counts, revenue, conversion rates or crash logs).
- Does **not** bypass Apple's 500-review per-sort-order per-country public feed window (use `reviewSort: "both"` and multiple `countries` for broader review coverage).
- Does **not** scrape macOS-only applications distributed outside the App Store.

### ⚠️ Trademark Notice

This Actor is an independent data-collection tool developed by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Apple Inc. "Apple", "App Store", "iOS", "iPad", and "iTunes" are trademarks of Apple Inc., referenced strictly to describe compatibility with public App Store listings.

### ⚖️ Is It Legal to Scrape Public Apple App Store Data?

This Actor reads only publicly available App Store product pages, chart rankings and public customer reviews visible to any unauthenticated visitor — with zero Apple ID sign-in or authentication bypass. Public customer reviews include user-chosen nicknames; ensure your downstream storage and processing comply with GDPR, CCPA and applicable local regulations.

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.2 — 2026-11-14

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent setup, Standby HTTP query examples, measured platform QA & D+0 billing benchmarks, worked PPE cost breakdowns, and expanded 12-question FAQ.

#### 0.1 — 2026-11-13

- Initial release of `foxlabs/apple-app-store-scraper` supporting 175-country iOS app lookup, web-page `inAppPurchases` & `privacyTypes` enrichment, dual-sort customer reviews, keyword search, batch-enriched Top Charts, and Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/apple-app-store-scraper/changelog.md

# Actor input Schema

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

Apple App Store numeric IDs ('310633997'), iOS bundle IDs ('com.openai.chat') or apps.apple.com URLs ('https://apps.apple.com/us/app/whatsapp-messenger/id310633997').

## `searchQueries` (type: `array`):

Keywords to search on the Apple App Store (e.g. 'habit tracker', 'ai note taker').

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

Optionally scrape an Apple App Store Top Chart (automatically enriched with full app ratings, versions and developer websites via batch lookup).

## `genreId` (type: `string`):

Optional numeric Apple genre ID for Top Charts (e.g. '6015' Finance, '6007' Productivity, '6000' Business, '6014' Games). Leave empty for overall chart.

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

Two-letter App Store country codes (e.g. \['us'], or \['us', 'gb', 'de', 'ca', 'au'] to aggregate reviews and regional pricing across multiple storefronts).

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

Choose whether to emit both app metadata + reviews, reviews only, or app metadata rows only.

## `reviewSort` (type: `string`):

Sort order for customer reviews ('both' fetches both Most Recent and Most Helpful feeds and deduplicates by reviewId).

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

Maximum reviews to collect per app per storefront country (up to 500 per sort order, 1000 with 'both').

## `maxSearchResults` (type: `integer`):

Maximum apps returned per keyword in 'searchQueries' (1..200).

## `chartLimit` (type: `integer`):

Number of ranked apps to fetch when 'chartType' is enabled (1..100).

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

Overall cap on delivered rows across the entire run (0 = unlimited).

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

Keep only reviews with rating >= minRating.

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

Keep only reviews with rating <= maxRating (e.g. set to 2 to extract 1-2 star bug reports and complaints).

## `postedAfter` (type: `string`):

Optional ISO date cut-off for reviews (e.g. '2026-01-01').

## `enrichWebDetails` (type: `boolean`):

Fetches apps.apple.com product page for emitted app rows to extract In-App Purchase price tiers, Privacy Policy URL and App Privacy labels.

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

Apify Proxy settings. Works out of the box on default Apify Proxy.

## Actor input object example

```json
{
  "apps": [
    "310633997",
    "com.openai.chat"
  ],
  "chartType": "none",
  "countries": [
    "us"
  ],
  "mode": "appsAndReviews",
  "reviewSort": "mostrecent",
  "maxReviewsPerApp": 15,
  "maxSearchResults": 20,
  "chartLimit": 25,
  "maxResults": 35,
  "minRating": 1,
  "maxRating": 5,
  "enrichWebDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `dataset` (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": [
        "310633997",
        "com.openai.chat"
    ],
    "countries": [
        "us"
    ],
    "maxReviewsPerApp": 15,
    "maxResults": 35,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/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 = {
    "apps": [
        "310633997",
        "com.openai.chat",
    ],
    "countries": ["us"],
    "maxReviewsPerApp": 15,
    "maxResults": 35,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/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 '{
  "apps": [
    "310633997",
    "com.openai.chat"
  ],
  "countries": [
    "us"
  ],
  "maxReviewsPerApp": 15,
  "maxResults": 35,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call foxlabs/apple-app-store-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/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/jkfVdflniGRV4fM4p/builds/31fd6KDtQuQtbyW9D/openapi.json
