# Apple App Store Scraper: App Details, Ratings and Top Charts (`themineworks/apple-app-store-scraper`) Actor

Search the Apple App Store, look up apps by id, link or bundle id, or read top free, paid and grossing charts by category. One row per app: price, rating, star histogram, version, size, in-app purchases with prices, privacy labels, screenshots, developer. No login.

- **URL**: https://apify.com/themineworks/apple-app-store-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Developer tools, Marketing, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.62 / 1,000 apps

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 Scraper: App Details, Ratings and Top Charts

[![20 App Store apps with in-app purchases, star histogram and privacy labels in 34 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/apple-app-store-scraper-hero.png)](https://console.apify.com/actors/RbW7laWGrnKgaOrMk/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [App Store Reviews Scraper](https://apify.com/themineworks/app-store-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [Google Play Reviews Scraper](https://apify.com/themineworks/google-play-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 140,000 runs across 170+ public actors.

Updated 21 Oct 2026: first release. Search by keyword, look up apps by id, link or bundle id, and read the top free, paid and grossing charts by category, one flat row per app. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **What the API leaves out, in columns.** Apple's public API gives price, rating, version and size. This actor also opens each app's App Store page and adds the subtitle, whether the app sells in-app purchases and the list of them with prices, the star histogram (how many 1 to 5 star ratings), its current chart rank in its category, Editors' Choice, the age rating, the privacy labels and the privacy policy link. In our test runs on 21 Oct 2026 every one of 346 rows had the histogram and the in-app purchase flag.
- **Three ways in, one schema.** Search terms, a list of app ids or links, and the top charts (free, paid, grossing, iPhone or iPad, overall or per category) all return the same row, with `source`, `search_position` or `chart_position` telling you where each app came from.
- **Pay per app, nothing for errors.** Ids Apple does not sell in your storefront, bad links, duplicates found twice in one run and the summary row are never charged. No Apple account, cookies or API key.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/RbW7laWGrnKgaOrMk/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Marketing, SEO and reviews family:** [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Trustpilot Reviews Scraper](https://apify.com/themineworks/trustpilot-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google Trends Scraper](https://apify.com/themineworks/google-trends-pro?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 20 apps for "meditation" in the US App Store with their App Store pages opened. It took 34 seconds in our test run:

```json
{
  "searchQueries": ["meditation"],
  "country": "us",
  "maxItems": 20
}
```

Put several terms on separate lines to run several searches at once, add app ids to `appIds`, or pick charts in `charts`. An app that two of your sources find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 1,600 apps at this actor's price.

#### Copy to your AI assistant

```text
themineworks/apple-app-store-scraper on Apify. Reads Apple App Store app metadata by search term, app id or top chart and returns one flat row per app, with no login. Call ApifyClient("TOKEN").actor("themineworks/apple-app-store-scraper").call(run_input={"searchQueries": ["meditation"], "country": "us", "maxItems": 50}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (list of terms, up to 200 apps each), appIds (numeric ids, id389801252, apps.apple.com links or bundle ids such as com.burbn.instagram, up to 5000), charts (any of topfree, toppaid, topgrossing, topfreeipad, toppaidipad, topgrossingipad; up to 100 apps each) or any mix. Optional: chartCategory (App Store genre id such as 6013 Health & Fitness or 6014 Games, empty for all), country (two letter storefront, default us), maxItems (default 50, 1 to 200, per search and per chart), includePageDetails (default true; opens each app page for subtitle, has_in_app_purchases, in_app_purchases, rating_histogram, chart_rank, editors_choice, age_rating, privacy labels, copyright, privacy_policy_url, platforms, similar_app_ids). App rows have no _type field and carry app_id, bundle_id, name, subtitle, developer_name, developer_id, developer_url, seller_name, developer_website, price, currency, formatted_price, is_free, rating, rating_count, rating_current_version, rating_count_current_version, rating_histogram, version, release_date, last_updated, size_bytes, size_mb, minimum_os_version, languages, languages_full, primary_genre, primary_genre_id, genres, genre_ids, content_rating, age_rating, advisories, description, release_notes, screenshots, ipad_screenshots, appletv_screenshots, icon, icon_small, app_url, features, supported_devices_count, is_game_center_enabled, has_in_app_purchases, in_app_purchases (name, price), in_app_purchases_listed, editors_choice, chart_rank, chart_rank_category, supports_game_controller, privacy_data_used_to_track, privacy_data_linked_to_you, privacy_data_not_linked_to_you, privacy_data_not_collected, privacy_policy_url, copyright, platforms, similar_app_ids, country, source, search_term, search_position, chart, chart_category, chart_position, input, page_details_scraped, page_error, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when apps were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~apple-app-store-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Search like the App Store.** Each term returns up to 200 apps in Apple's own order, with `search_position`, so you can track where an app ranks for a keyword over time.
- **Top charts by category.** Top Free, Top Paid and Top Grossing for iPhone or iPad, overall or for one category such as Games, Finance or Health & Fitness, up to 100 apps each with `chart_position`.
- **Direct lookups.** Paste app ids, App Store links or bundle ids. A link keeps its own storefront, so `https://apps.apple.com/gb/app/...` is read in the UK store even when `country` is us.
- **In-app purchases with prices.** `has_in_app_purchases` is true or false for every app with the page opened, and `in_app_purchases` lists the purchases the App Store shows (up to 10) with their local price, for example Premium yearly at $59.99.
- **Ratings in depth.** Average rating and count for all versions and the current version, plus `rating_histogram` with the number of 1, 2, 3, 4 and 5 star ratings.
- **Privacy labels.** Data used to track you, data linked to you and data not linked to you, by category (Location, Purchases, Identifiers and so on), as the developer declared them.
- **Any storefront.** 174 countries. Prices, currency, ratings, ranks and availability are those of the storefront you pick.
- **Stops cleanly.** Six failed API requests in a row end the run; pages that keep failing are paused and the API rows still go out; the run stops before its time limit and keeps every row. The summary row says why.

### How to use it

#### Keyword research: who ranks for a term

```json
{
  "searchQueries": ["budget planner", "expense tracker", "money manager"],
  "country": "us",
  "maxItems": 100
}
```

Each term is its own search, labelled in `search_term`, with `search_position`. Sort by `rating_count` to see the established apps and by `release_date` to find the new ones.

#### Category charts: top grossing games

```json
{
  "charts": ["topgrossing", "topfree"],
  "chartCategory": "6014",
  "country": "us",
  "maxItems": 100
}
```

`chart_position` is the rank in the chart you asked for. `has_in_app_purchases`, `in_app_purchases` and `price` show how each app makes money.

#### Competitor tracking: a fixed list of apps

```json
{
  "appIds": [
    "389801252",
    "https://apps.apple.com/gb/app/whatsapp-messenger/id310633997",
    "com.spotlightsix.zentimer"
  ],
  "country": "us"
}
```

Every app listed is returned. Run it on a schedule and compare `version`, `last_updated`, `rating`, `rating_count`, `chart_rank` and `price` between runs.

#### Market entry: the same chart in several countries

Run one task per storefront (for example us, gb, de, in, jp) with the same chart and category. Join on `app_id` to see which apps lead everywhere and which only lead at home.

#### Fast API only export

```json
{
  "searchQueries": ["vpn"],
  "maxItems": 200,
  "includePageDetails": false
}
```

Rows come from Apple's API only: price, rating, version, size, languages, genres, description, release notes, screenshots and the developer. 200 apps take a few seconds this way. Same price per app.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | array of strings | empty | Search terms, one search each, for example `meditation`. Up to 100. |
| `appIds` | array of strings | empty | App ids, App Store links or bundle ids. Up to 5,000. |
| `charts` | array of strings | empty | Any of `topfree`, `toppaid`, `topgrossing`, `topfreeipad`, `toppaidipad`, `topgrossingipad`. |
| `chartCategory` | string | all | App Store genre id for the charts, for example `6014` Games or `6015` Finance. |
| `country` | string | `us` | Two letter storefront code. |
| `maxItems` | integer | `50` | Most apps per search term and per chart, 1 to 200. App ids are always all returned. |
| `includePageDetails` | boolean | `true` | Opens each app's App Store page for the fields the API lacks. |

Give `searchQueries`, `appIds`, `charts` or any mix.

### What data do you get?

| Group | Fields |
|---|---|
| App | `app_id`, `bundle_id`, `name`, `subtitle`, `app_url`, `icon`, `icon_small`, `screenshots`, `ipad_screenshots`, `appletv_screenshots`, `description`, `release_notes` |
| Developer | `developer_name`, `developer_id`, `developer_url`, `seller_name`, `developer_website`, `copyright`, `privacy_policy_url` |
| Price | `price`, `currency`, `formatted_price`, `is_free`, `has_in_app_purchases`, `in_app_purchases`, `in_app_purchases_listed` |
| Ratings | `rating`, `rating_count`, `rating_current_version`, `rating_count_current_version`, `rating_histogram` |
| Version | `version`, `release_date`, `last_updated`, `size_bytes`, `size_mb`, `minimum_os_version`, `platforms`, `features`, `supported_devices_count` |
| Category and rank | `primary_genre`, `primary_genre_id`, `genres`, `genre_ids`, `chart_rank`, `chart_rank_category`, `editors_choice`, `similar_app_ids` |
| Audience | `content_rating`, `age_rating`, `advisories`, `languages`, `languages_full` |
| Privacy | `privacy_data_used_to_track`, `privacy_data_linked_to_you`, `privacy_data_not_linked_to_you`, `privacy_data_not_collected` |
| Where it came from | `country`, `source`, `search_term`, `search_position`, `chart`, `chart_category`, `chart_position`, `input`, `page_details_scraped`, `scraped_at` |

#### Stable fields for automations

These were present in every app row of our test runs (346 rows from searches, charts and id lookups in the us, de and gb stores, pages on), and their names will not change:

| Field | What it is |
|---|---|
| `app_id` | The key to store and join on |
| `bundle_id` | Bundle id |
| `name` | App name |
| `developer_name` | Developer |
| `price` | Price, 0 when free |
| `currency` | Currency code |
| `rating` | Average rating |
| `rating_count` | Number of ratings |
| `version` | Current version |
| `last_updated` | Date of the current version |
| `size_bytes` | Download size |
| `primary_genre` | Main category |
| `content_rating` | Content rating |
| `app_url` | App Store link |
| `has_in_app_purchases` | Sells in-app purchases (pages on) |
| `rating_histogram` | Ratings per star (pages on) |
| `country` | Storefront |
| `source` | search, chart or app_id |

Optional, present only when Apple shows a value: `in_app_purchases` (256 of 346 test rows: the apps that sell them), `developer_website` (303 of 346), `chart_rank` (165 of 346: only apps currently in their category chart), privacy label lists (empty lists are left out), `advisories`, `ipad_screenshots` (apps without an iPad version have none), `editors_choice` true (11 of 346).

#### Output examples

One app from the "meditation" search with its page opened (test run, 21 Oct 2026, long texts and lists trimmed):

```json
{
  "app_id": "571800810",
  "bundle_id": "com.calm.calmapp",
  "name": "Calm",
  "subtitle": "Sleep, Meditation, Relaxation",
  "developer_name": "Calm.com",
  "developer_id": "571800813",
  "seller_name": "Calm.com, Inc.",
  "developer_website": "https://www.calm.com",
  "price": 0,
  "currency": "USD",
  "formatted_price": "Free",
  "is_free": true,
  "rating": 4.77,
  "rating_count": 1989059,
  "rating_histogram": { "1": 33046, "2": 16605, "3": 52631, "4": 165948, "5": 1720829 },
  "version": "7.3",
  "release_date": "2013-02-22T20:09:23Z",
  "last_updated": "2026-10-08T20:43:45Z",
  "size_bytes": 178897920,
  "size_mb": 178.9,
  "minimum_os_version": "18.0",
  "primary_genre": "Health & Fitness",
  "genres": ["Health & Fitness", "Lifestyle"],
  "content_rating": "4+",
  "age_rating": "9+",
  "has_in_app_purchases": true,
  "in_app_purchases": [
    { "name": "Calm Premium", "price": "$79.99" },
    { "name": "Calm Premium", "price": "$16.99" }
  ],
  "in_app_purchases_listed": 10,
  "editors_choice": true,
  "chart_rank": 52,
  "chart_rank_category": "Health & Fitness",
  "privacy_data_used_to_track": ["Purchases", "Identifiers", "Usage Data"],
  "privacy_data_linked_to_you": ["Health & Fitness", "Purchases", "Contact Info", "Search History", "Identifiers", "Usage Data", "Diagnostics"],
  "privacy_policy_url": "http://www.calm.com/privacy",
  "copyright": "© Calm.com, Inc.",
  "platforms": ["tv", "watch", "phone", "pad"],
  "app_url": "https://apps.apple.com/us/app/calm/id571800810",
  "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/84/9f/5f/849f5ff1-ceb7-d05d-00f8-7877b02544b8/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg",
  "country": "us",
  "source": "search",
  "search_term": "meditation",
  "search_position": 3,
  "page_details_scraped": true,
  "scraped_at": "2026-10-21T07:11:27.765Z"
}
```

An id that Apple does not sell in the storefront you picked gets a free error row:

```json
{ "_type": "error", "error_type": "not_found", "identifier": "999999999", "country": "jp", "reason": "Apple has no app with this id in the jp storefront. It may be removed or not sold there; try another country." }
```

### Pricing

Pay per event: you pay for the apps you receive, plus a flat $0.003 per run, whatever memory you choose. Opening App Store pages costs nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `app-scraped` | Once per app row stored in your dataset | $3.10 per 1,000 | $2.80 per 1,000 | $2.25 per 1,000 | $1.62 per 1,000 |
| `run-start` | Once per run, after the first source returned apps | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one app is the price per 1,000 divided by 1,000.

Never charged:

- ids, links or bundle ids Apple does not sell in the storefront, and inputs that are not App Store ids (each gets an error row);
- an app that a second source of the same run finds again;
- apps past your `maxItems`;
- the summary, info and error rows;
- a run with no valid input, or one whose sources return no apps: the start fee is charged only once a source has returned apps;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `app_id` with `chart_position`, `rating_count`, `version` and `price` to see rank moves, rating growth, new releases and price changes.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

Apple's public iTunes Search and Lookup APIs, the public App Store chart feeds, and, with `includePageDetails` on, each app's public page on apps.apple.com, as anyone sees them without signing in. It does not sign in, download apps or read anything behind an Apple account.

#### How many apps can I get?

Up to 200 per search term (Apple's own limit for its search API), up to 100 per chart, and up to 5,000 listed app ids per run. For more apps on a topic, add more search terms or category charts; each app is delivered once per run.

#### Why does a search return slightly fewer apps than maxItems?

Apple's search answers a few apps fewer than asked for. The actor asks for 10 more than `maxItems` and cuts to `maxItems`, so a short result means Apple had no more apps for that term.

#### What is the difference between includePageDetails on and off?

Off: rows come from Apple's API only, which is quicker. On (the default): each app's App Store page is opened as well for the subtitle, in-app purchases, star histogram, chart rank, Editors' Choice, age rating, privacy labels, copyright, developer links, platforms and similar apps. Same price either way.

#### Why is chart_rank empty for some apps?

`chart_rank` is the position the App Store page shows for the app in its own category chart. Apps that are not currently in that chart have none. `chart_position` is different: it is the rank in the chart you asked for in `charts`.

#### Are the in-app purchase prices in my currency?

They are in the currency of the storefront you picked, written the way the App Store writes them there, for example `$59.99` in the US or `7,99 €` in Germany. The App Store page lists up to 10 in-app purchases per app; `in_app_purchases_listed` says how many it listed.

#### Can I get reviews too?

This actor returns app metadata. For the review texts use [App Store Reviews Scraper](https://apify.com/themineworks/app-store-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), and for Android apps [Google Play Reviews Scraper](https://apify.com/themineworks/google-play-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

#### Do I need an account, cookies or a proxy?

No. The actor reads public pages over Apify Proxy, which is included. Nothing to set up.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Apps, Charts and search ranks, and Price, in-app purchases and privacy. In CSV and Excel, lists and objects such as `in_app_purchases` and `rating_histogram` are flattened into columns such as `in_app_purchases/0/price` and `rating_histogram/5`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/apple-app-store-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http apple-app-store-scraper "https://mcp.apify.com/?tools=themineworks/apple-app-store-scraper"`

#### Is it legal to scrape the App Store?

The actor reads only public app listings that anyone can see without signing in, published by developers so their apps are found, mostly through Apple's own public APIs. You are responsible for how you use the data, including Apple's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's apps to a sheet with Apify's Google Sheets integration; one row per app fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new apps in the top grossing finance chart every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Trustpilot Reviews Scraper](https://apify.com/themineworks/trustpilot-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Trends Scraper](https://apify.com/themineworks/google-trends-pro?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Semrush Scraper](https://apify.com/themineworks/semrush-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [App Reviews Scraper](https://apify.com/themineworks/app-reviews-monitor?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Trustpilot Business Search](https://apify.com/themineworks/trustpilot-business-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [TripAdvisor Reviews Scraper](https://apify.com/themineworks/tripadvisor-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Username Checker](https://apify.com/themineworks/username-checker?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Backlink Building Agent](https://apify.com/themineworks/backlink-building-agent?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found an app that comes back with a field empty, or a chart that looks different from the App Store? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search the Apple App Store, look up apps or read the top charts and get every app back as one row, with price, ratings and star histogram, version, size, in-app purchases with prices, privacy labels and screenshots, no login.*

# Actor input Schema

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

Words as you would type them in the App Store search box, one per line, for example meditation, budget planner, vpn. Each term is one search and returns up to 200 apps in Apple's order. Up to 100 terms per run.

## `appIds` (type: `array`):

Apps to read directly, one per line: a numeric id (389801252), id389801252, an App Store link (https://apps.apple.com/us/app/instagram/id389801252) or a bundle id (com.burbn.instagram). A link keeps its own storefront; ids and bundle ids use Country. Every app listed is returned, up to 5,000.

## `charts` (type: `array`):

Read one or more App Store top charts, up to 100 apps each in rank order. Pick a category below to read that category's chart.

## `chartCategory` (type: `string`):

Category for the top charts. Leave on All categories for the overall charts.

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

Two letter App Store storefront code: us, gb, de, fr, in, jp, br and so on. Prices, ratings, ranks and availability are those of this storefront.

## `maxItems` (type: `integer`):

The most apps to return for each search term and each chart, 1 to 200. Apple returns at most 200 per search and 100 per chart. App ids you list are always all returned.

## `includePageDetails` (type: `boolean`):

On: each app's App Store page is opened too, for subtitle, in-app purchases (yes or no and the list with prices), star histogram, chart rank, Editors' Choice, age rating, privacy labels, copyright and developer links. Off: rows come from Apple's API only, which is faster. Same price either way.

## Actor input object example

```json
{
  "searchQueries": [
    "meditation"
  ],
  "chartCategory": "all",
  "country": "us",
  "maxItems": 20,
  "includePageDetails": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (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 = {
    "searchQueries": [
        "meditation"
    ],
    "country": "us",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 = {
    "searchQueries": ["meditation"],
    "country": "us",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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 '{
  "searchQueries": [
    "meditation"
  ],
  "country": "us",
  "maxItems": 20
}' |
apify call themineworks/apple-app-store-scraper --silent --output-dataset

```

## MCP server setup

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