Apple App Store Scraper (search, app details, reviews, monitor)

Search the Apple App Store by keyword, or hand over app IDs and URLs, and get one flat row per app — price, rating, rating count, version, size, release dates, genres, minimum iOS, content rating, developer and description — plus the app's public customer reviews as their own rows. Search, details, reviews and change monitoring in one actor, one run, one dataset.

What you get

App rows (kind: "app"): id, url, appId, bundleId, name, developer, price, currency, isFree, averageRating, ratingCount, version, releasedAt, updatedAt, sizeBytes, genres, minOs, contentRating, description, iconUrl, query, rank, source, scrapedAt.

Review rows (kind: "review"): id, url, appId, appName, reviewId, title, text, rating, version, reviewedAt, scrapedAt.

Reviews carry no reviewer identity — no nickname, no profile link, no reviewer ID. Only the review text, its star rating, the app version it was written against and the date.

Example output

App row (appIds: ["324684580"], storefront us):

Field	Example value
url	https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580
name / bundleId	Spotify: Music and Podcasts / com.spotify.client
developer	Spotify
price / currency / isFree	0.0 / USD / true
averageRating / ratingCount	4.77395 / 42037741
version / updatedAt	9.1.80 / 2026-09-07T12:04:45Z
releasedAt / sizeBytes	2011-07-14T11:22:37Z / 300476416
genres / minOs / contentRating	["Music", "Entertainment"] / 16.1 / 12+

Review row from the same run:

Field	Example value
reviewId / rating	14537353039 / 4
title	Love it but there’s one thing..
text	Maybe I’m just missing something, but I’d like to see and option to select numerous songs from a playlist or Liked Songs list to remove at one time instead of having to individually remove. Otherwise, Spotify is the best!
version / reviewedAt	9.1.80 / 2026-09-11T07:57:53-07:00

Top of searchTerms: ["meditation"]:

rank	name	developer	averageRating	ratingCount
1	Insight Timer: Meditate, Sleep	Insight Network Inc	4.89512	446184
2	Headspace: Sleep & Meditation	Headspace Inc.	4.84227	973857
3	Calm	Calm.com	4.7726	1980426

Use cases

• Keyword / ASO research — pull the whole first page of a search term with ratings, rating counts and update dates, and see who actually owns the keyword.
• Competitor tracking — watch a list of app IDs and get an alert the moment a competitor ships a version, changes price or slips in rating.
• Review mining — collect up to 500 recent or most-helpful reviews per app per storefront and feed them into your own tagging or sentiment pipeline.
• Market sizing — rating counts, price and release dates for every app in a category keyword, in one CSV.

How it works

1. Search — each keyword goes to Apple's public iTunes Search API (entity=software) for the storefront you chose, so the ranking and the fields are Apple's own, not a guess parsed off a page.
2. Details — each app ID goes to the public iTunes Lookup API. If a storefront has no record for an ID, the actor falls back to the server-rendered app page and reads its SoftwareApplication metadata.
3. Reviews — Apple's public customer-reviews feed, 50 per page, up to 10 pages (500 reviews) per app and storefront, sorted by most recent or most helpful.
4. Monitor mode — re-runs the same input and returns only apps and reviews that are new or changed since the previous run (apps compare version, price, rating and rating count; reviews compare rating and text), with optional webhook and Telegram alerts.

Input

Field	Meaning	Default
searchTerms	Keywords to search the store for	["meditation"]
appIds	App IDs or App Store URLs to scrape directly	empty
country	Storefront code (us, gb, de, jp, …)	us
includeReviews	Also return review rows	true
maxReviewsPerApp	Reviews per app (0-500)	100
reviewSort	mostrecent or mosthelpful	mostrecent
maxAppsPerSearch	Apps per search term (1-200)	50
maxItems	Stop after this many rows in total	100
mode	scrape or monitor (only new/changed since last run)	scrape
monitorKey, webhookUrl, telegramBotToken, telegramChatId	Monitor-mode state key and alert targets	empty

Pricing

Event	Price
result	$0.001 per row ($1 per 1,000 apps or reviews)
monitor-check	$0.005 per monitor run
change	$0.001 per new/changed row

You are charged only for rows actually pushed. A run that finds nothing pushes nothing and costs no result events. The actor needs no proxy, so there is no proxy surcharge either.

Why this actor

• Search, app details, reviews and monitoring in one actor — no chaining two or three scrapers to get a keyword list with its reviews.
• Reads Apple's official public JSON endpoints, so fields are typed and complete instead of regexed off a page that changes every quarter.
• Any storefront: country switches price, currency, ratings and reviews together.
• No charge for empty runs, and the RUN_SUMMARY record explains an empty run instead of leaving you guessing.

Limits

• Reviews come from Apple's public review feed, which serves at most 500 reviews per app per storefront (10 pages × 50) and only those left in that storefront. Run several storefronts to widen the sample. The app page itself renders its reviews in the browser and carries none in its HTML, so there is no deeper source to fall back on.
• Pace: Apple rate-limits these endpoints at about 20 calls per minute, so the actor sends one request every 3 seconds. Budget roughly 15 minutes for 100 apps with reviews (about 3 requests per app), or well under a minute for a plain keyword search with includeReviews: false.
• Ratings are storefront-specific: averageRating and ratingCount for us are not the worldwide totals.
• description is truncated to 1,000 characters.
• No in-app purchase list, no download estimates, no chart positions — Apple publishes none of them.
• No reviewer names, reviewer profiles or any other person-level data, by design.

FAQ

Do I need a proxy? No. The endpoints answer without one, and the actor runs on the none tier, so there is no proxy cost on top.

Can I get more than 500 reviews for an app? Not from Apple's public feed for one storefront. Running the same app across several storefronts (us, gb, ca, au, …) is the supported way to collect more.

Why is averageRating different from what I see in the App Store app? The store app shows your own storefront; set country to the same storefront and the numbers match.

Does it return who wrote a review? No. Nicknames, reviewer profile links and reviewer IDs are dropped before anything is written to the dataset.

Changelog

• 0.1: initial release — keyword search, app details by ID or URL, customer reviews (recent / most helpful), app-page fallback for IDs missing from a storefront, monitor mode.

---

If this actor saved you time, a short review on its Store page genuinely helps other people find it. Found a bug or need a field that is missing? Open a ticket on the Issues tab.