# App Store Apps Scraper (`properscraper/app-store-apps-scraper`) Actor

Search the Apple App Store by keyword, or look apps up by link, ID or bundle ID: name, developer, price, rating and number of ratings, version, release notes, description, category, size and screenshots. For iPhone, iPad and Mac, in any country.

- **URL**: https://apify.com/properscraper/app-store-apps-scraper.md
- **Developed by:** [jake mcclure](https://apify.com/properscraper) (community)
- **Categories:** Developer tools, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 app saveds

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 Apps Scraper

Search the Apple App Store by keyword, or look apps up by link, ID or bundle ID. For each app you get its name, developer, price, rating and number of ratings, version and release notes, description, category, size, languages, icon and screenshots.

It works for iPhone, iPad and Mac apps in any country's App Store, and uses Apple's own public search API, so no login or API key is needed.

Use it to:

- research a market: who ranks for a keyword, at what price and with what ratings
- track competitors' versions, release notes and ratings by running it on a schedule
- do app store optimisation (ASO): see which apps a search term returns, in each country
- build a list of app developers in a category, with their websites, as leads
- enrich a list of app IDs or bundle IDs with full details

### Input

Give it searches, apps, or both.

| Field | What it does |
|---|---|
| **Searches** | One per line, such as `habit tracker`. Each search saves the best-matching apps, in the App Store's own order. |
| **Apps** | One per line: an App Store link, a numeric ID such as `310633997`, or a bundle ID such as `net.whatsapp.WhatsApp`. |
| **Apps per search** | The most apps saved for each search, 1 to 200. Default 50. |
| **Country** | The App Store to read, as a two-letter code: `us`, `gb`, `de`, `jp`… Default `us`. |
| **Device** | iPhone (default), iPad or Mac. Used for searches. |
| **Include the description and release notes** | On by default. Turn off for a smaller export. |

```json
{
    "searches": ["habit tracker", "budget planner"],
    "apps": ["https://apps.apple.com/us/app/notion/id1232780281", "net.whatsapp.WhatsApp"],
    "maxAppsPerSearch": 100,
    "country": "gb"
}
```

### Output

One record per app:

```json
{
    "search": "habit tracker",
    "appId": "1438388363",
    "bundleId": "com.example.habits",
    "name": "Habit Tracker",
    "developer": "Example Apps Ltd",
    "developerId": "1438388362",
    "developerUrl": "https://apps.apple.com/gb/developer/example-apps/id1438388362",
    "developerWebsite": "https://example-apps.com",
    "url": "https://apps.apple.com/gb/app/habit-tracker/id1438388363",
    "price": 0,
    "formattedPrice": "Free",
    "currency": "GBP",
    "isFree": true,
    "rating": 4.73,
    "ratingCount": 23244,
    "currentVersionRating": 4.73,
    "currentVersionRatingCount": 23244,
    "version": "2.15.13",
    "releasedAt": "2018-10-11T07:00:00.000Z",
    "updatedAt": "2026-11-10T09:14:02.000Z",
    "releaseNotes": "Bug fixes and a new weekly summary.",
    "description": "Build good habits and break bad ones…",
    "primaryGenre": "Productivity",
    "genres": ["Productivity", "Health & Fitness"],
    "contentRating": "4+",
    "minimumOsVersion": "16.0",
    "sizeBytes": 318016512,
    "languages": ["EN", "DE", "FR"],
    "iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/…/512x512bb.jpg",
    "screenshots": ["https://is1-ssl.mzstatic.com/image/thumb/…/392x696bb.jpg"],
    "ipadScreenshots": [],
    "country": "gb",
    "scrapedAt": "2026-11-18T12:00:00.000Z"
}
```

- `search` is the search that found the app, or `null` for an app you listed.
- `price`, `currency`, ratings and availability are those of the chosen country's store. Ratings are per country.
- `updatedAt` is when the current version was released; `releasedAt` is when the app first appeared.
- `developerWebsite` is the site the developer gives Apple, where there is one.
- An app found twice, by two searches or by a search and a lookup, is saved once.

A `SUMMARY` record in the run's key-value store lists how many apps each search or batch saved and any apps that were not found.

### Pricing

Pay per result. You are charged once for each app saved to the dataset, at the per-result price shown on this page. Apps that are not in the chosen country's store, and lines that are not an app link or ID, are not saved and cost nothing. The run stops as soon as it reaches the maximum charge you set for it.

### Limits

- Apple returns at most 200 apps for a search and has no further pages. For wider coverage, use several narrower searches.
- Search results are Apple's API ranking, which is close to, but not always identical to, what the App Store app shows on a phone.
- Apple asks for about 20 requests a minute, so each search or batch of 50 looked-up apps takes about three seconds.
- Reviews are not included. Use an App Store reviews tool for those.
- In-app purchase prices and download numbers are not published by Apple.

### Is this allowed?

The Actor uses the iTunes Search API, which Apple provides publicly for finding content in its stores, at the rate Apple asks for. App names, icons and screenshots belong to their developers and to Apple.

# Actor input Schema

## `searches` (type: `array`):

One per line, for example: weather, budget planner, language learning. Each search saves the best-matching apps, as the App Store ranks them.

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

One per line: a link to the app's App Store page, its numeric ID (such as 310633997) or its bundle ID (such as net.whatsapp.WhatsApp).

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

The most apps saved for each search. Apple returns at most 200.

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

The App Store to read, as a two-letter country code: us, gb, de, fr, jp and so on. Prices, ratings and availability differ by country.

## `device` (type: `string`):

Which apps to search for. Only used for searches.

## `includeDescription` (type: `boolean`):

Turn off for a smaller export.

## Actor input object example

```json
{
  "searches": [
    "habit tracker"
  ],
  "maxAppsPerSearch": 50,
  "country": "us",
  "device": "iphone",
  "includeDescription": true
}
```

# Actor output Schema

## `apps` (type: `string`):

Every app saved by the run, one record per app.

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

Totals for the run and, for each search or batch of apps, how many results were saved and any error.

# 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 = {
    "searches": [
        "habit tracker"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("properscraper/app-store-apps-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 = { "searches": ["habit tracker"] }

# Run the Actor and wait for it to finish
run = client.actor("properscraper/app-store-apps-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 '{
  "searches": [
    "habit tracker"
  ]
}' |
apify call properscraper/app-store-apps-scraper --silent --output-dataset

```

## MCP server setup

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