Get Apple App Store app
Get an Apple App Store app: price, ratings, version, genres, screenshots and more, by app id or bundle id.
Headers
Get your API keyAPI key (`sfk_...`)
App Store app id (digits, e.g. `284882215`) or bundle id (e.g. `com.facebook.Facebook`). An id with the `id` prefix used in App Store links (`id284882215`) is also accepted.
min 1 chars · max 155 chars
Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, reviews and text are specific to it. A code Apple does not run a store for is refused. Default: `us`.
pattern: ^[a-zA-Z]{2}$
Language of the text, as `ll-cc`, e.g. `es-mx` or `ja-jp`. Changes the language of descriptions and price labels inside the storefront. Default: the storefront's own language.
pattern: ^[a-z]{2}[-_][a-z]{2}$
Endpoint-specific response payload.
`not_found` when the app, developer or storefront has no match. An app removed from the store, one that never existed and one not offered in this storefront all look the same.
one of: found, not_found
Storefront (country) the record is for.
The app; null when `lookupStatus` is `not_found`.
App Store app id.
Bundle id, e.g. `com.facebook.Facebook`.
App name.
The app's App Store page.
`ios` for iPhone and iPad apps, `mac` for Mac apps.
any of: ios, mac (comma-separated)
Platform family the app is sold on.
one of: ios, mac
Device families the app supports. Empty for Mac apps. An iPad-only app lists just `ipad`.
any of: iphone, ipad, ipod (comma-separated)
Device family the app runs on.
one of: iphone, ipad, ipod
The developer an app is published under.
App Store developer id.
Developer name.
The developer's App Store page.
The seller of record.
Legal seller name. Differs from the developer name for about a third of apps.
The seller's website; null when none is listed.
Price of the app in this storefront.
Price in the storefront currency; 0 for free apps. Null when Apple lists no price (some Apple Arcade games).
ISO 4217 currency code.
Price as the App Store displays it, in the storefront language, e.g. `Free` or `$4.99`.
Star ratings in this storefront. Apple keeps one count per storefront; there is no worldwide total.
Average star rating (0 to 5); null when nobody has rated.
Number of ratings in this storefront; 0 when none.
Ratings that apply to the current version only.
Average rating of the current version; null when it has no ratings.
Ratings of the current version in this storefront.
Age rating such as `4+` or `17+`. The app route and the details route return the current store tier when it is available; app records inside list responses can still carry Apple's older tier.
Content descriptors behind the age rating, in the storefront language.
All genres.
App Store genre id, e.g. `6005`.
Genre name in the storefront language.
An App Store genre (category).
App Store genre id, e.g. `6005`.
Genre name in the storefront language.
The version currently on sale.
Version string.
When this version was released (ISO-8601).
Release notes; null when the developer wrote none.
When the app first went on sale (ISO-8601).
Lowest OS version that runs the app.
Download size in bytes.
Language codes the app supports, as Apple lists them (e.g. `EN`, `ZH`).
Feature flags Apple lists, e.g. `iosUniversal`, `gameCenter`.
Whether the app supports Game Center.
Whether Apple Business Manager can license it per device.
Store description (up to 4,000 characters).
Icon image URLs hosted by Apple.
60 px icon.
100 px icon.
512 px icon.
Screenshot URLs hosted by Apple.
iPhone screenshots.
iPad screenshots.
Apple TV screenshots.
Mac screenshots.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/apple-app-store/apps/284882215" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store app.