# App Store Scraper - Search, Details, Reviews, Charts & Ranks (`appdata-labs/app-store-scraper`) Actor

All-in-one Apple App Store scraper: keyword search with search API rank, full app details, customer reviews filtered by stars, keyword and date, top charts by country and genre, and every app by a publisher. Type an app name, URL or ID. Official Apple APIs, no login.

- **URL**: https://apify.com/appdata-labs/app-store-scraper.md
- **Developed by:** [Kobkoon Janngam](https://apify.com/appdata-labs) (community)
- **Categories:** Agents, MCP servers, SEO tools
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 result returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## App Store Scraper — Search, Details, Reviews, Charts & Ranks

**One Actor for Apple App Store data:** keyword search with each app's search API rank, full app details, customer reviews, top charts and every app by a publisher.

**Built for** app marketers doing ASO and competitor research, analysts tracking a category, and AI agents that need App Store facts as small, consistent JSON rows. **Quick start:** press **Start** with no configuration — it searches the US store for "habit tracker" and "budget app" and returns 20 apps in a few seconds.

### Sample output

From a real default run (`mode: search`, US storefront) on 2026-11-18:

| searchQuery | searchRank | title | developer | primaryGenre | formattedPrice | rating | ratingCount | version |
|---|---|---|---|---|---|---|---|---|
| habit tracker | 1 | Habit Tracker | InnerGrow | Productivity | Free | 4.79 | 149,008 | 2.15.13 |
| habit tracker | 2 | Habit Tracker - HabitKit | Sebastian Roehl | Productivity | Free | 4.84 | 2,599 | 1.19.2 |
| habit tracker | 3 | Onrise: Habit Tracker & Focus | Maximilian Munker | Productivity | Free | 4.84 | 2,619 | 1.1.9 |
| budget app | 1 | Budget app - spending tracker | InnerGrow | Finance | Free | 4.72 | 16,397 | 1.17.4 |
| budget app | 2 | EveryDollar: Budget Management | The Lampo Group Incorporated | Finance | Free | 4.73 | 84,269 | 2026.11.160 |
| budget app | 3 | Monarch: Budget & Track Money | Monarch Money, Inc. | Finance | Free | 4.89 | 118,925 | 2.0.132 |

Search, details and developer rows also carry `appId`, `bundleId`, `url`, `developerId`, `description` (a bounded preview), `price`, `currency`, `ratingCurrentVersion`, `releaseDate`, `currentVersionReleaseDate`, `releaseNotes`, `contentRating`, `minimumOsVersion`, `fileSizeBytes`, `genres`, `languages`, `icon`, `screenshots` and `country`. Every row, in every mode, carries `mode`.

### Modes

Set `mode` and fill only the fields that mode reads. Everything else is ignored.

| mode | reads | one row per | key fields |
|---|---|---|---|
| `search` (default) | `searchKeywords`, `country`, `maxResultsPerInput` | app found for a keyword | `searchQuery`, `searchRank`, app fields |
| `details` | `apps`, `country` | app you named | full app fields |
| `reviews` | `apps`, `country`, `maxResultsPerInput`, `reviewSort`, `minRating`, `maxRating`, `reviewKeywords`, `reviewsSince` | review | `reviewId`, `rating`, `title`, `text`, `version`, `updatedAt`, `feedSort`, `appTitle` |
| `charts` | `chart`, `chartCategoryId`, `country`, `maxResultsPerInput` | chart entry | `rank`, `title`, `developer`, `category`, `rating`, `ratingCount` |
| `developer` | `apps`, `country`, `maxResultsPerInput` | app by that publisher | app fields with `developer`, `developerId` |

#### What `searchRank` means — and what it does not

`searchRank` is the position of the app in the response of **Apple's iTunes Search API** for that keyword and storefront. It is a strong, repeatable signal and the same one every API-based tool uses, but it is **not guaranteed to match the order the App Store app shows on an iPhone**, which Apple personalises and tunes separately. We call it the search API rank, never "the App Store rank", so you do not build a report on a claim we cannot back.

#### Type what you know

The `apps` field takes an **app name** as the store shows it (`Duolingo`), an **App Store URL**, a **numeric app ID** or a **bundle ID**, mixed freely. In developer mode it also takes a **publisher name** (`Spotify`) or Apple's developer ID. Names are accepted only on an exact or prefix title match, so you are never charged for a look-alike app. Each entry is judged on its own: one that cannot be found is skipped and named in the log and in `SUMMARY`, and the run fails only if none resolve.

### What you can do with it

- **Keyword research for ASO.** See which apps hold the top search API positions for the keywords you target, with their ratings and update dates.
- **Competitor complaints.** `reviews` mode with `maxRating: 2` and `reviewKeywords: ["crash", "subscription"]` returns only the reviews that matter, and you pay only for those.
- **Category tracking.** Schedule `charts` mode for a genre and country and you have a daily ranking history.
- **Portfolio mapping.** `developer` mode lists everything a studio ships, from any one of its apps.
- **Feed an AI agent.** Rows are bounded under 4 KB, consistently shaped, and identical in shape across runs.

### Reliability

This Actor reads only Apple's official iTunes Search and Lookup APIs and its public RSS feeds. There is no HTML parsing, so an App Store redesign does not break it. Apple's review feed sometimes goes silent for an app in one country or sort order and answers with an empty page rather than an error; reviews mode retries, tries Apple's other sort order, and tries a few other storefronts before believing it. Every row says which country and order it came from. If nothing comes back at all, the run fails with an explanation instead of succeeding with an empty dataset.

### Pricing

$0.004 per row returned, in every mode — $4 per 1,000 results. A run that returns nothing is not charged, and the run stops at your spending limit rather than overshooting it.

### Works well with

Same publisher, same output conventions, same honest-failure rules:

- [**app-store-app-details**](https://apify.com/appdata-labs/app-store-app-details) — Full App Store listing for any app, or search the store by keyword.
- [**app-store-reviews**](https://apify.com/appdata-labs/app-store-reviews) — Customer reviews, filtered by stars, keyword and date — pay only for matches.
- [**app-store-top-charts**](https://apify.com/appdata-labs/app-store-top-charts) — Top free, paid and grossing charts for any country and category.
- [**app-store-developer-apps**](https://apify.com/appdata-labs/app-store-developer-apps) — Every iOS app a publisher has released, from one app or the publisher name.
- [**google-play-app-details**](https://apify.com/appdata-labs/google-play-app-details) — Full Google Play listing: installs, rating histogram, developer contact.
- [**google-play-developer-apps**](https://apify.com/appdata-labs/google-play-developer-apps) — Every Android app a publisher has released.
- [**google-play-similar-apps**](https://apify.com/appdata-labs/google-play-similar-apps) — Competitors Google Play itself shows next to an app.
- [**google-play-category-apps**](https://apify.com/appdata-labs/google-play-category-apps) — The apps in any Google Play category, with installs and developer contact.
- [**google-play-scraper**](https://apify.com/appdata-labs/google-play-scraper) — All-in-one Google Play: app details, a developer's apps, similar apps and category lists.

### Disclaimer

This is an **unofficial** tool. It is not affiliated with, authorised by, endorsed by, or in
any way officially connected to Apple Inc. "Apple", "App Store", "iOS", "iPadOS" and "macOS"
are trademarks of Apple Inc.

It reads only Apple's **public, unauthenticated** endpoints — the iTunes Search and Lookup
APIs and the public RSS feeds. It signs into nothing, stores no credentials, and parses no
HTML. Nothing it returns is behind a login or a paywall, and every field it returns is data
the App Store already shows to anyone.

Apple can change or withdraw those endpoints at any time. When a feed returns nothing, this
Actor says so in the log rather than handing you an empty result that looks like an answer.

# Actor input Schema

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

What to fetch. search: apps for keywords, with searchRank. details: full listings for the apps you name. reviews: customer reviews for those apps, with optional star, keyword and date filters. charts: a top chart for one country and genre. developer: every app by the publisher of each app or developer you name.

## `searchKeywords` (type: `array`):

One search per keyword, read in search mode only. Each row carries searchQuery and searchRank: the position in the results of Apple's iTunes Search API, which usually tracks but can differ from the order the App Store app shows on an iPhone.

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

Each entry can be an app name as the store shows it (Duolingo), an App Store URL (https://apps.apple.com/us/app/notion/id1232780281), a numeric app ID (1232780281) or a bundle ID (com.burbn.instagram). In developer mode it can also be a publisher name (Spotify) or Apple's numeric developer ID (284882218). Each entry is resolved on its own: one that cannot be found is skipped with a reason, and the run fails only if none resolve.

## `country` (type: `string`):

Two-letter code of the App Store storefront to read, for example us, gb, de, jp or th. Search results, charts, prices and reviews are all per country.

## `maxResultsPerInput` (type: `integer`):

Search: results per keyword. Reviews: reviews per app. Charts: chart length. Developer: apps per publisher. Details returns one row per app and ignores it. Capped at Apple's own limits: 200, or 500 for reviews. Every row is charged, so keep it small for fast, cheap runs.

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

Which Apple chart to read in charts mode. Each row carries its rank, plus rating and rating count added from a lookup.

## `chartCategoryId` (type: `string`):

Four-digit Apple genre ID to narrow the chart, for example 6014 (Games), 6007 (Productivity), 6015 (Finance) or 6013 (Health & Fitness). Leave empty for the overall chart.

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

mostRecent returns the newest reviews first, for monitoring. mostHelpful returns the reviews Apple ranks highest, for research. If the order asked for is silent for an app, the other is used and each row says which in feedSort.

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

Keep only reviews with at least this many stars, 1 to 5. Leave at 1 for no lower bound. Filtering happens before charging: you pay only for reviews that match.

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

Keep only reviews with at most this many stars, 1 to 5. Leave at 5 for no upper bound. Set 2 for complaints and bug reports.

## `reviewKeywords` (type: `array`):

Keep only reviews whose title or text contains at least one of these words or phrases, case-insensitive. Leave empty for no keyword filter. Example: crash, subscription, refund.

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

Keep only reviews written or updated on or after this date, in YYYY-MM-DD form, for example 2026-09-01. Leave empty for no date filter.

## `includeFullText` (type: `boolean`):

Off by default. App descriptions run to thousands of characters and a dozen screenshot URLs, which makes rows too big for an AI agent. Turn on for the complete text and every screenshot in search, details and developer modes.

## Actor input object example

```json
{
  "mode": "search",
  "searchKeywords": [
    "habit tracker",
    "budget app",
    "meditation"
  ],
  "apps": [
    "Duolingo",
    "https://apps.apple.com/us/app/notion/id1232780281",
    "com.burbn.instagram"
  ],
  "country": "us",
  "maxResultsPerInput": 10,
  "chart": "topGrossingApps",
  "chartCategoryId": "6014",
  "reviewSort": "mostRecent",
  "minRating": 4,
  "maxRating": 2,
  "reviewKeywords": [
    "crash",
    "subscription",
    "refund"
  ],
  "reviewsSince": "2026-09-01",
  "includeFullText": false
}
```

# Actor output Schema

## `rows` (type: `string`):

One row per app, review or chart entry. Every row carries mode, so a stored row says which question it answers.

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

What was requested, what was delivered, and anything skipped with the reason.

# 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": "search",
    "searchKeywords": [
        "habit tracker",
        "budget app"
    ],
    "apps": [
        "https://apps.apple.com/us/app/notion/id1232780281",
        "310633997",
        "363590051"
    ],
    "country": "us",
    "maxResultsPerInput": 10,
    "chart": "topFreeApps",
    "chartCategoryId": "",
    "reviewSort": "mostRecent",
    "minRating": 1,
    "maxRating": 5,
    "reviewKeywords": [],
    "reviewsSince": "",
    "includeFullText": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("appdata-labs/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": "search",
    "searchKeywords": [
        "habit tracker",
        "budget app",
    ],
    "apps": [
        "https://apps.apple.com/us/app/notion/id1232780281",
        "310633997",
        "363590051",
    ],
    "country": "us",
    "maxResultsPerInput": 10,
    "chart": "topFreeApps",
    "chartCategoryId": "",
    "reviewSort": "mostRecent",
    "minRating": 1,
    "maxRating": 5,
    "reviewKeywords": [],
    "reviewsSince": "",
    "includeFullText": False,
}

# Run the Actor and wait for it to finish
run = client.actor("appdata-labs/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": "search",
  "searchKeywords": [
    "habit tracker",
    "budget app"
  ],
  "apps": [
    "https://apps.apple.com/us/app/notion/id1232780281",
    "310633997",
    "363590051"
  ],
  "country": "us",
  "maxResultsPerInput": 10,
  "chart": "topFreeApps",
  "chartCategoryId": "",
  "reviewSort": "mostRecent",
  "minRating": 1,
  "maxRating": 5,
  "reviewKeywords": [],
  "reviewsSince": "",
  "includeFullText": false
}' |
apify call appdata-labs/app-store-scraper --silent --output-dataset

```

## MCP server setup

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