Apple App Store Scraper 🍏 — Rankings, Reviews & App Details

Scrape the Apple App Store as clean, structured JSON — top-chart rankings by category & country, app reviews, complete app details, and keyword search. One actor, four jobs.

Fast and reliable: built on Apple's own app data feeds, with proxy rotation and fully-paginated reviews. The perfect companion to a Google Play scraper for cross-platform app intelligence.

💡 The differentiator: most App Store actors only fetch a single app's details. This one owns top-chart rankings (a market-intelligence feed: any category × any country × Top Free / Paid / Grossing / New) and delivers reviews at scale.

---

📋 Table of contents

• What does it do?
• Use cases
• How to use it
• Input parameters
• Input examples
• Output — data fields
• Sample output records
• Categories & countries
• Tips & best practices
• Frequently asked questions
• Changelog

---

What does it do?

Pick a mode and get clean data:

• 🏆 Rankings — the Top Free / Top Paid / Top Grossing / New charts for any category and country (with rank position and full app details).
• 💬 Reviews — app reviews (sort by most recent / most helpful), with rating, title, text, version and date — up to ~500 per app per country.
• 📋 App details — complete app info: rating, ratings & reviews count, ratings histogram, price, developer, category, version, size, screenshots and more.
• 🔎 Search — apps for a keyword.

Export to JSON, CSV, Excel, XML or HTML, or pull from the Apify API. Everything is localized by country.

---

Use cases

📈 ASO & app market intelligence

• Track top-chart rankings by category and country (build a Sensor Tower / data.ai alternative).
• Monitor competitors and category leaders across markets.

💬 Review analysis & product teams

• Pull reviews for your app and competitors' for sentiment, bugs and feature requests.

🏢 Competitive & investment research

• See who's climbing the charts; compare ratings and pricing across apps.

🤖 Data & AI teams

• Build app datasets, review-sentiment models and ranking dashboards (pair with a Google Play scraper for full cross-platform coverage).

---

How to use it (step by step)

No coding required.

1. Click Try for free / Start.
2. Choose a mode:
   • Rankings → pick a chart (Top Free/Paid/Grossing/New), category and country.
   • Reviews / App details → add App IDs (numeric 389801252, bundle com.burbn.instagram, or App Store URLs).
   • Search → add search terms.
3. Set country and Max items.
4. Click Save & Start, then export the results.

---

Input parameters

Field	Type	Description
mode	string	rankings, reviews, appDetails, or search.
collection	string	Rankings chart: TOP_FREE_IOS, TOP_PAID_IOS, TOP_GROSSING_IOS, NEW_IOS.
category	string	Rankings category (empty = overall), e.g. GAMES, SOCIAL_NETWORKING, FINANCE, GAMES_PUZZLE.
appIds	array	App IDs (numeric / bundle) or URLs (reviews & appDetails modes).
searchTerms	array	Keywords (search mode).
maxReviewsPerApp	integer	Reviews per app (max ~500). Default 200.
reviewsSort	string	RECENT or HELPFUL.
country	string	Country code (us, gb, de, kr, jp …).
fullDetail	boolean	Fetch full app details for each ranked/found app. Default true.
maxItems	integer	Max records. 0 = no limit. Default 1000.
proxyConfiguration	object	Optional.
maxConcurrency	integer	Parallel apps processed. Default 4.

---

Input examples

1) Top free apps in the US

{
  "mode": "rankings",
  "collection": "TOP_FREE_IOS",
  "country": "us",
  "maxItems": 200
}

2) Top grossing games in Japan

{
  "mode": "rankings",
  "collection": "TOP_GROSSING_IOS",
  "category": "GAMES",
  "country": "jp"
}

3) Reviews for an app (most recent)

{
  "mode": "reviews",
  "appIds": ["389801252", "com.spotify.client"],
  "maxReviewsPerApp": 500,
  "reviewsSort": "RECENT",
  "country": "us"
}

4) App details

{
  "mode": "appDetails",
  "appIds": ["https://apps.apple.com/us/app/instagram/id389801252"]
}

---

Output — data fields

Ranked app / app (recordType: "rankedApp" / "app"): appId (numeric), bundleId, title, url, description, developer, developerId, developerWebsite, score, reviews, currentVersionScore, currentVersionReviews, histogram, price, free, currency, genre, genreId, genres, contentRating, languages, size, requiredOsVersion, released, updated, version, releaseNotes, icon, screenshots, ipadScreenshots, supportedDevices. Ranked apps also have rank, collection, rankCategory.

Review (recordType: "review"): appId, bundleId, reviewId, userName, userUrl, version, score, title, text, url, updated.

---

Sample output records

Ranked app:

{
  "recordType": "rankedApp",
  "rank": 1,
  "collection": "TOP_FREE_IOS",
  "rankCategory": "overall",
  "country": "us",
  "appId": 389801252,
  "bundleId": "com.burbn.instagram",
  "title": "Instagram",
  "developer": "Instagram, Inc.",
  "score": 4.7,
  "reviews": 26500000,
  "price": 0,
  "free": true,
  "genre": "Photo & Video",
  "url": "https://apps.apple.com/us/app/instagram/id389801252"
}

Review:

{
  "recordType": "review",
  "appId": 389801252,
  "reviewId": "1234567890",
  "userName": "appfan99",
  "score": 5,
  "title": "Love it",
  "text": "Works great after the latest update!",
  "version": "300.0",
  "updated": "2026-06-01T10:00:00Z"
}

---

Categories & countries

• Charts: TOP_FREE_IOS, TOP_PAID_IOS, TOP_GROSSING_IOS, NEW_IOS.
• Categories: overall (empty) or specific ones like GAMES, SOCIAL_NETWORKING, PHOTO_AND_VIDEO, FINANCE, HEALTH_AND_FITNESS, PRODUCTIVITY, ENTERTAINMENT, SHOPPING, plus game subcategories (GAMES_PUZZLE, GAMES_ACTION, …).
• Countries: any App Store storefront via country (us, gb, de, kr, jp, br, …).

---

Tips & best practices

• 🏆 Rankings are recurring — schedule a daily run per category/country to track movement.
• 🌍 Iterate countries to compare charts across markets.
• 💬 Set maxReviewsPerApp high for full review history (up to ~500/app/country).
• 🍏🤖 Pair with a Google Play scraper for complete cross-platform app intelligence.
• 💾 Use the Apify API / integrations to push results into Google Sheets, a database, or a webhook.

---

Frequently asked questions

Can I get the top-chart rankings for a category and country? Yes — that's the rankings mode.

Is there a review limit? Apple serves up to ~500 reviews per app per country; set maxReviewsPerApp.

Are prices and rankings localized? Yes — everything respects country.

Can I use bundle IDs or URLs? Yes — numeric IDs, bundle IDs (com.x) and App Store URLs all work.

What export formats are supported? JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations.

---

Changelog

0.1.0

• Initial release: rankings (Top Free/Paid/Grossing/New by category & country), paginated reviews, full app details, and keyword search.
• Localized by country; proxy rotation; one mode-switched actor.