Apple App Store Scraper

One Actor for the whole App Store surface. Pick a mode with scraperType and the run produces catalog records, ranked search results, a publisher's portfolio, recent reviews, or the US top-free chart.

scraperType	What a row is	What you supply
appDetail	One complete catalog record	app_ids
searchApps	One ranked app per result	queries
developerApps	One app from a publisher's catalog	developer_ids
reviews	One recent public review	app_ids
charts	One ranked chart entry	nothing

Fill in the section for the mode you picked and leave the others alone. country and maxItems sit at the bottom because almost every mode reads them.

App details

{
  "scraperType": "appDetail",
  "app_ids": [
    "324684580",
    "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
  ],
  "country": "US",
  "maxItems": 0
}

Numeric IDs and apps.apple.com links can be mixed, and duplicates are read once. A US lookup returned this subset:

{
  "app_id": "324684580",
  "name": "Spotify: Music and Podcasts",
  "bundle_id": "com.spotify.client",
  "developer_id": "324684583",
  "developer_name": "Spotify",
  "formatted_price": "Free",
  "currency": "USD",
  "average_rating": 4.77569,
  "rating_count": 41657897,
  "primary_genre": "Music",
  "version": "9.1.76",
  "country": "US"
}

The full record also carries seller_name, description, price, genres, release_date, current_version_release_date, release_notes, minimum_os_version, content_advisory_rating, languages, supported_devices, file_size_bytes, artwork_url, screenshots, ipad_screenshots, appletv_screenshots, app_store_url, developer_url, and seller_url.

Keyword search and developer portfolios

{
  "scraperType": "searchApps",
  "queries": ["spotify", "weather radar"],
  "country": "US",
  "maxItems": 100
}

Search rows are the same complete catalog record as appDetail, plus search_query tying each row to the phrase that found it. Apple returns at most 200 results for one search request, so maxItems: 0 removes the Actor-side cap without extending a query past that ceiling.

Swap queries for developer_ids and set scraperType to developerApps for a publisher's catalog instead; those rows carry source_developer_id.

Reviews

{
  "scraperType": "reviews",
  "app_ids": ["324684580"],
  "country": "US",
  "maxReviews": 100
}

{
  "app_id": "324684580",
  "country": "US",
  "review_id": "14455499988",
  "author_name": "Marilyn in FL",
  "updated_at": "2026-08-21T09:45:22-07:00",
  "rating": 5,
  "review_version": "9.1.76",
  "review_title": "Spotify Playlists",
  "helpful_vote_count": 0,
  "helpful_vote_sum": 0
}

Rows can also carry author_url and the full review text; those are null when the feed omits them. Developer replies are not part of this output.

The chart

{
  "scraperType": "charts",
  "maxItems": 100
}

Chart rows carry rank, app_id, name, developer_id, developer_name, artwork_url, genres, release_date, kind, app_store_url, and country.

Things worth knowing before the first run

Does country change the chart? No. The chart mode always reads the United States top-free listing, whatever country is set to. The dedicated Apple App Store Charts Scraper pins the field to a US-only dropdown; a shared form cannot, because the other four modes accept any storefront.

How many reviews can one app return? At most 500 per app and country, and only from the recent window — this is not complete review history. maxReviews accepts 1–500 and applies per app, so two apps at 100 can return 200 rows. Schedule repeated runs and deduplicate on review_id for an ongoing monitor.

Why is maxItems 100 rather than 0? The modes disagree about the right default, so the shared one ships. Set 0 when you are feeding a long app_ids or developer_ids list. In the chart mode the published snapshot tops out at 100 entries regardless, so 0 still returns at most 100 rows.

One mode per run, or several? One. scraperType selects a single dataset and the other sections are ignored for that run.

What happens when a lookup fails? An ID missing from the selected country is skipped and the rest of the list continues. A developer with no apps in that storefront, or an app with an empty review feed, finishes successfully with no rows. Optional fields stay null or empty when Apple does not publish them, and availability is storefront-specific — an empty result in one country does not prove the app or publisher is gone elsewhere.

Prefer a narrower form? Every mode also ships on its own: Apple App Store App Scraper, Apple App Store Search Scraper, Apple App Store Developer Apps Scraper, Apple App Store Reviews Scraper, and Apple App Store Charts Scraper.