Primary genre
primaryGenre
Optional
Apple's main category for the app.
App Store Search Scraper
Pricing
from $0.90 / 1,000 app returneds
Search the Apple App Store across any storefront and get the full 40-field app record - ratings, pricing, size, version history, screenshots and publisher - plus customer reviews attached free inside the row, read with the retry logic Apple's flaky review feed actually needs.
App ID
appId
Optional
Apple's numeric identifier for the app. Stable across runs and storefronts, and the key this Actor deduplicates on. Null only on the explanatory row a zero-result run emits.
Bundle ID
bundleId
Optional
Reverse-DNS bundle identifier, e.g. com.duolingo.DuolingoMobile. The key that joins an App Store row to a Google Play row or an internal build.
App name
title
Optional
App name as published on the storefront searched.
Developer
developer
Optional
The seller Apple lists for the app.
Developer ID
developerId
Optional
Apple's numeric identifier for the developer.
Developer page
developerUrl
Optional
App Store page listing everything this developer publishes.
App Store URL
appStoreUrl
Optional
Public App Store page for the app.
Description
description
Optional
Full App Store description text.
Release notes
releaseNotes
Optional
What's-new text for the current version.
Version
version
Optional
Current version string.
Price
price
Optional
Numeric price in the storefront's currency. 0 for free apps.
Price (formatted)
formattedPrice
Optional
Price as Apple displays it, e.g. "Free" or "$4.99".
Currency
currency
Optional
ISO currency code for the storefront searched.
Is free
isFree
Optional
True when price is zero. Null when Apple returned no price.
Average rating
averageUserRating
Optional
Mean star rating across all versions, rounded to two decimals.
Rating count
userRatingCount
Optional
How many ratings that average is built from. The number that says whether the rating means anything.
Average rating (current version)
averageUserRatingCurrentVersion
Optional
Mean star rating for the current version only.
Rating count (current version)
userRatingCountCurrentVersion
Optional
Ratings counted for the current version only.
Primary genre
primaryGenre
Optional
Apple's main category for the app.
Primary genre ID
primaryGenreId
Optional
Numeric id of the primary genre, for feeding back into the genre filter.
Genres
genres
Optional
Every genre Apple assigns the app.
Genre IDs
genreIds
Optional
Numeric ids matching the genres above.
First released
releaseDate
Optional
When the app first appeared on the App Store.
Last updated
currentVersionReleaseDate
Optional
When the current version shipped. Together with the first-release date this is how you tell an actively maintained app from an abandoned one.
Size (bytes)
fileSizeBytes
Optional
Download size in bytes.
Size (MB)
fileSizeMB
Optional
Download size in megabytes, rounded to one decimal.
Minimum iOS
minimumOsVersion
Optional
Lowest OS version the app supports.
Content rating
contentRating
Optional
Apple's age rating, e.g. 4+, 12+, 17+.
Advisories
advisories
Optional
Content warnings Apple attaches to the app.
Languages
languages
Optional
ISO codes for every language the app is localised into.
Supported devices
supportedDevices
Optional
Device models the app runs on.
Features
features
Optional
Apple feature flags, e.g. iosUniversal.
Game Center
isGameCenterEnabled
Optional
Whether the app integrates Game Center.
Screenshots
screenshotUrls
Optional
Full-size iPhone screenshot URLs.
iPad screenshots
ipadScreenshotUrls
Optional
Full-size iPad screenshot URLs.
Icon URL
artworkUrl
Optional
App icon at the largest size Apple serves (512px where available).
Icon URL (small)
artworkUrlSmall
Optional
App icon at 100px.
Storefront
country
Optional
Two-letter storefront this row was read from. Price, currency and availability are all storefront-specific.
Platform
platform
Optional
Which catalogue the row came from: iphone, ipad or mac.
Reviews
reviews
Optional
Customer reviews attached to this app, each with rating, title, body, author, app version and helpful-vote counts. Null unless "Include customer reviews" was on.
Reviews returned
reviewsReturned
Optional
How many reviews are attached to this row.
Reviews status
reviewsStatus
Optional
How the review read went: not_requested, ok, page_limit, or unavailable. "unavailable" means Apple's feed was degraded for every sort order tried, which is NOT the same as the app having no reviews.
Review order used
reviewsSortUsed
Optional
Which sort order actually produced the reviews. Differs from the requested order when the Actor had to fall back.
Empty review pages
reviewPagesEmpty
Optional
How many review pages came back empty and were walked past. Apple's feed returns empty pages mid-run and resumes afterwards, so this is normal rather than an error.
Chart rank
chartRank
Optional
Position in Apple's top-apps chart. Null unless this row came from a chart.
Chart
chartType
Optional
Which chart produced the row: top-free or top-paid.
Chart storefront
chartCountry
Optional
Storefront the chart was read from.
Search term
searchTerm
Optional
Keyword that surfaced this app. Null for chart and direct-lookup rows.
Search storefront
searchCountry
Optional
Storefront the keyword was searched in.
Source URL
sourceUrl
Optional
The exact Apple endpoint this row was read from, so any row can be reproduced by hand.
Scraped at
scrapedAt
Optional
UTC timestamp for when the run collected the row.
No results
noResults
Optional
Present and true only on the single explanatory row a zero-result run emits.
Message
message
Optional
Why a zero-result run returned nothing, and what to change. Present only on that explanatory row.