App Store Scraper – App Details & Top Charts

Name: App Store Scraper – App Details & Top Charts
Price: 0.001 USD

sfoln/app-store-scraper · Ecommerce, Developer tools, Automation

Apple App Store data by app ID, bundle ID or URL in any country: name, developer, price, rating, ratings count, version, release notes, size, genres, screenshots. Plus keyword search, customer reviews and top free, paid and grossing charts. $1 per 1,000 apps, $0.10 per 1,000 reviews.

Open in Apify Store Run it$1 / 1,000 app store app, more below

About

What it does

Get Apple App Store data as clean JSON: app details by app ID, bundle ID or App Store URL in any country, customer reviews, keyword search results and top free, paid and grossing charts. One record per app, review or chart entry, for app-market research, ASO and competitor tracking, review monitoring and AI agents. $1 per 1,000 apps, $0.10 per 1,000 reviews, no start fee; unknown apps and errors are free.

Price

Price per delivered record

Event	Price	Per 1,000	Charged for
App Store app `app`	$0.001	$1 / 1,000	One app record: the details of an app in one App Store country (apps mode), or one app of a keyword search (search mode).
App Store review `review`	$0.0001	$0.10 / 1,000	One customer review row (rating, title, text, version, author name, date).
Top chart entry `chart-entry`	$0.0005	$0.50 / 1,000	One app of a top chart (rank, app ID, name, developer, link).

Apify free plan: up to 10 items per run. Paid plans have no per-run cap; set maxTotalChargeUsd to cap spend.

Run

Call it from code, an agent or the Console

curl · synchronous run, rows in the response

curl -X POST "https://api.apify.com/v2/actors/sfoln~app-store-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"apps":["1232780281"]}'

mcp.json · hosted Apify MCP server

{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=sfoln/app-store-scraper"
    }
  }
}

asynchronous run · for large batches

POST https://api.apify.com/v2/actors/sfoln~app-store-scraper/runs?maxTotalChargeUsd=1
GET  https://api.apify.com/v2/actor-runs/{runId}            # until status is SUCCEEDED
GET  https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json

Authenticate with an Apify API token. MCP clients can instead sign in with OAuth when prompted. Example prompt for an agent: Get the App Store details (rating, ratings count, version, price) of app 1232780281 in the US and UK stores.

Input

Input fields

Pick a mode and fill its list: apps (App Store IDs, bundle IDs or URLs) for app details or customer reviews, keywords for search, or charts for top charts. Every app, keyword or chart is fetched in each country you list. Each one is an item with its own summary in the dataset.

Field	Type	Default	Meaning
`mode`	`string`	`"apps"`	Mode apps: one record per app with its details. reviews: the app's customer reviews (newest 500 per country). search: apps matching each keyword. charts: top free, paid or grossing apps. One of `"apps"`, `"reviews"`, `"search"`, `"charts"`.
`apps`	`array`	—	Apps For the apps and reviews modes: App Store app IDs (1232780281), bundle IDs (notion.id) or App Store URLs (https://apps.apple.com/us/app/notion/id1232780281), one per line. Accounts on the Apify free plan can process up to 10 items per run (an item is one app, keyword or chart in one country).
`searchTerms`	`array`	—	Search keywords For the search mode: keywords to search the App Store for, one per line. Results come in Apple's order with their rank.
`charts`	`array`	—	Charts For the charts mode: which top charts to fetch (default top-free).
`chartGenre`	`string`	—	Chart genre Optional, charts mode: limit the charts to one genre, by App Store genre ID (6014) or name (Games, Productivity, Finance, Health & Fitness…).
`countries`	`array`	—	Countries Two-letter App Store country codes (us, gb, de, jp…). Every app, keyword or chart is fetched in each of them. Empty: us, or the country in an App Store URL.
`includeReviews`	`boolean`	`false`	Include reviews (apps mode) In the apps mode, also return each app's customer reviews (up to Max reviews per app, charged per review).
`maxReviewsPerApp`	`integer`	`100`	Max reviews per app Reviews returned per app and country (1–500; Apple serves the newest or most helpful 500 at most). Range 1–500.
`reviewSort`	`string`	`"mostrecent"`	Review order mostrecent: newest reviews first. mosthelpful: the reviews other users voted most helpful. One of `"mostrecent"`, `"mosthelpful"`.
`maxSearchResults`	`integer`	`50`	Max search results Apps returned per keyword and country (1–200). Range 1–200.
`chartSize`	`integer`	`100`	Chart size Entries returned per chart and country (1–100). Range 1–100.
`maxItems`	`integer`	`1000`	Max items Safety cap on items processed in this run (an item is one app, keyword or chart in one country); the rest is reported as dropped. Range 1–10000.
`concurrency`	`integer`	—	Concurrency Items processed in parallel (1–10). Default: 10 for apps (lookups are batched), 2 for reviews and charts, 1 for search. Apple's rate limit applies to the whole run either way. Range 1–10.
`includeRaw`	`boolean`	`false`	Include raw upstream response Attach Apple's unmodified JSON to each record under raw (larger output).

Example input

{
  "apps": [
    "1232780281"
  ]
}

Output

One record per input item

Records land in the run's dataset; a synchronous call returns them directly. Each has a status (ok is charged; everything else is free) and a charged flag. The run's OUTPUT record totals items and charges.

Field	Type	Meaning
`input`	`string \| object`	Input The input item this record belongs to (the app, keyword, chart, account or post, with its country or mode).
`status`	`string`	Status ok \| not_found \| error \| skipped_invalid \| skipped_budget \| skipped_free_plan \| skipped_unmetered e.g. `"ok"`
`charged`	`boolean`	Charged Whether this record incurred a pay-per-event charge.
`chargedEvent`	`string`	Charged event Pay-per-event event charged for this record (present only when charged).
`chargedCount`	`integer`	Events charged Events actually charged when the charge came back short of the requested count (present only then; a warning explains it).
`source`	`string`	Source Upstream data source.
`fetchedAt`	`string`	Fetched at ISO timestamp.
`error`	`object`	Error { code, message, provider?, status? } when status is not ok. Codes set by the runtime: budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed; upstream codes: auth, insufficient_credits, rate_limit, timeout, network, server, client, invalid_response, not_found.
`warnings`	`array`	Warnings Notes about this record, e.g. a charge that came back short.
`raw`	`object`	Raw Apple's unmodified JSON for the app, review or chart entry (only with includeRaw).
`recordType`	`string`	Record type app (app details or a search result), review, chart-entry, or summary (one per input item: what was delivered and why it stopped).
`position`	`integer`	Position Order of this row among the rows of its input (1-based).
`country`	`string \| null`	Country Two-letter App Store country (storefront) code.
`appId`	`string \| null`	App ID Numeric App Store app ID (as text).
`bundleId`	`string \| null`	Bundle ID The app's bundle identifier, e.g. notion.id.
`name`	`string \| null`	Name App name in this storefront (chart entries: as listed in the chart).
`url`	`string \| null`	App Store URL Link to the app's App Store page.
`developer`	`string \| null`	Developer Developer (artist) name.
`developerId`	`string \| null`	Developer ID Numeric App Store developer ID.
`developerUrl`	`string \| null`	Developer page App Store page of the developer.
`sellerName`	`string \| null`	Seller Legal seller name shown on the App Store.
`developerWebsite`	`string \| null`	Developer website The developer's own website, when listed.
`price`	`number \| null`	Price Price in the storefront currency (0 = free).
`currency`	`string \| null`	Currency ISO currency code of the price.
`formattedPrice`	`string \| null`	Formatted price Price as shown on the App Store (e.g. Free, $4.99).
`isFree`	`boolean \| null`	Free True when the price is 0.
`rating`	`number \| null`	Rating App rows: average user rating (1–5) across all versions. Review rows: the review's star rating (1–5). Summary rows (reviews mode): the app's average rating.
`ratingCount`	`integer \| null`	Ratings Number of user ratings across all versions.
`ratingCurrentVersion`	`number \| null`	Rating (current version) Average rating of the current version.
`ratingCountCurrentVersion`	`integer \| null`	Ratings (current version) Number of ratings of the current version.
`version`	`string \| null`	Version App rows: current version. Review rows: the app version the review was written for.
`currentVersionReleaseDate`	`string \| null`	Current version released ISO timestamp of the current version's release.
`releaseNotes`	`string \| null`	Release notes What's new in the current version.
`releaseDate`	`string \| null`	Release date App rows: ISO timestamp of the first release. Chart rows: release date (YYYY-MM-DD).
`description`	`string \| null`	Description Full App Store description.
`sizeBytes`	`integer \| null`	Size (bytes) Download size in bytes.
`minimumOsVersion`	`string \| null`	Minimum OS Minimum iOS/macOS version.
`primaryGenre`	`string \| null`	Primary genre Primary App Store genre (category).
`primaryGenreId`	`string \| null`	Primary genre ID Numeric ID of the primary genre.
`genres`	`array`	Genres All genres of the app (chart rows: the genres the chart lists).
`genreIds`	`array`	Genre IDs Numeric IDs of the genres.
`contentRating`	`string \| null`	Content rating Age rating, e.g. 4+, 12+, 17+.
`advisories`	`array`	Advisories Content advisories behind the age rating.
`languages`	`array`	Languages ISO 639-1 codes of the languages the app supports.
`iconUrl`	`string \| null`	Icon URL of the app icon (512 px for apps, 100 px in charts).
`screenshotUrls`	`array`	iPhone screenshots URLs of the iPhone screenshots.
`ipadScreenshotUrls`	`array`	iPad screenshots URLs of the iPad screenshots.
`appleTvScreenshotUrls`	`array`	Apple TV screenshots URLs of the Apple TV screenshots.
`features`	`array`	Features App Store feature flags, e.g. iosUniversal.
`supportedDeviceCount`	`integer`	Supported devices Number of device models the app supports.
`gameCenterEnabled`	`boolean \| null`	Game Center True when the app uses Game Center.
`kind`	`string \| null`	Kind software (iPhone/iPad) or mac-software.
`reviewsDelivered`	`integer`	Reviews delivered Apps mode with includeReviews: review rows delivered for this app and country.
`reviewsStopReason`	`string`	Reviews stop reason Apps mode with includeReviews: why the reviews stopped (limit, end, free_plan, budget, error…).
`rank`	`integer`	Rank Position in the search results or in the chart (1 = first).
`searchTerm`	`string`	Search keyword Search rows: the keyword this app was found for.
`reviewId`	`string`	Review ID App Store review ID.
`title`	`string \| null`	Review title Title of the review.
`text`	`string \| null`	Review text Body of the review.
`authorName`	`string \| null`	Reviewer Reviewer's public nickname.
`updatedAt`	`string \| null`	Review date ISO timestamp of the review (or of its last edit).
`helpfulVotes`	`integer \| null`	Helpful votes Users who found the review helpful.
`totalVotes`	`integer \| null`	Votes Users who voted on the review's helpfulness.
`sort`	`string`	Review order mostrecent or mosthelpful.
`chart`	`string`	Chart top-free, top-paid or top-grossing.
`genreId`	`string \| null`	Chart genre Genre ID the chart is limited to (null: all genres).
`summary`	`string \| null`	Chart summary Short description from the chart feed (genre and top-grossing charts).
`appName`	`string \| null`	App name Summary rows (reviews mode): name of the app.
`term`	`string`	Keyword Summary rows (search mode): the keyword.
`resultsFound`	`integer`	Results found Summary rows (search mode): apps Apple returned.
`resultsDelivered`	`integer`	Rows delivered Summary rows: rows delivered (and charged) for this input item.
`stopReason`	`string`	Stop reason Summary rows: limit, end, free_plan, budget, aborted, deadline, empty_pages, max_pages or error.

Example record

{
  "input": {
    "mode": "apps",
    "app": "1232780281",
    "country": "us"
  },
  "recordType": "app",
  "appId": "1232780281",
  "bundleId": "notion.id",
  "name": "Notion: Notes, Tasks, AI",
  "url": "https://apps.apple.com/us/app/notion-notes-tasks-ai/id1232780281",
  "country": "us",
  "developer": "Notion Labs, Incorporated",
  "developerId": "1232780280",
  "developerUrl": "https://apps.apple.com/us/developer/notion-labs-incorporated/id1232780280",
  "sellerName": "Notion Labs, Incorporated",
  "developerWebsite": "https://www.notion.so",
  "price": 0,
  "currency": "USD",
  "formattedPrice": "Free",
  "isFree": true,
  "rating": 4.7752,
  "ratingCount": 90387,
  "ratingCurrentVersion": 4.7752,
  "ratingCountCurrentVersion": 90387,
  "version": "1.7.346",
  "currentVersionReleaseDate": "2026-10-13T04:16:20.000Z",
  "releaseNotes": "Bug fixes and performance improvements.",
  "releaseDate": "2017-09-14T19:07:31.000Z",
  "description": "Notion is an AI-powered all-in-one workspace…",
  "sizeBytes": 485872640,
  "minimumOsVersion": "18.0",
  "primaryGenre": "Productivity",
  "primaryGenreId": "6007",
  "genres": [
    "Productivity",
    "Business"
  ],
  "genreIds": [
    "6007",
    "6000"
  ],
  "contentRating": "4+",
  "advisories": [],
  "languages": [
    "AR",
    "DA",
    "NL",
    "EN",
    "FI",
    "FR",
    "DE"
  ],
  "iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ba/fa/05/AppIcon/512x512bb.jpg",
  "screenshotUrls": [
    "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/94/dd/d8/1.png/392x696bb.png"
  ],
  "ipadScreenshotUrls": [],
  "appleTvScreenshotUrls": [],
  "features": [
    "iosUniversal"
  ],
  "supportedDeviceCount": 118,
  "gameCenterEnabled": false,
  "kind": "software",
  "status": "ok",
  "charged": true,
  "chargedEvent": "app",
  "source": "appstore",
  "fetchedAt": "2026-10-14T21:48:14.000Z"
}

FAQ

Questions

Which apps can I look up?: Any app listed in the Apple App Store: pass its numeric ID (1232780281), its bundle ID (notion.id) or its App Store URL. iPhone, iPad and Mac apps are supported; an ID that is not an app (a developer ID, a removed app) comes back as not_found and is not charged.
How many reviews can I get per app?: Apple's public reviews feed serves the newest (or most helpful) 500 reviews per app and country, 50 per page. To collect more, run the same app in several countries: each storefront has its own reviews.
Why did a search fail with a rate_limit error?: Apple throttles keyword search per IP address. The Actor spaces its calls, pauses and tries again; if Apple still refuses, the keyword ends with status error, nothing is charged, and a later run usually succeeds.

Machine-readable

This page for agents

/actors/app-store-scraper.json — this API as JSON
/actors/app-store-scraper.md — this API as Markdown
apify.com/sfoln/app-store-scraper.md — the Store listing as Markdown
/catalog.json — the whole catalogue