Get Apple App Store app details
Get Apple App Store app details like rating histogram and version history.
Headers
Get your API keyAPI key (`sfk_...`)
Numeric App Store app id, e.g. `284882215`. 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}$
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 these details are for.
Which parts are present. Each part is independent: when one is unavailable, the other is still returned and the missing part's field is null.
Whether this part is present: ok, failed or skipped.
one of: ok, failed, skipped
Whether this part is present: ok, failed or skipped.
one of: ok, failed, skipped
What only the app record leaves out: featured reviews, similar apps, version label, in-app purchases (first 10) and more; null when it is temporarily unavailable or the app is not in this storefront.
App Store app id.
Bundle id.
App name.
Tagline under the name. Not in the app lookup.
The app's App Store page in this storefront.
The developer.
Developer id.
Developer name.
The developer's App Store page.
Platforms the app is offered on. `ios` covers iPhone and iPad.
any of: ios, mac, tv, watch, vision, messages (comma-separated)
one of: ios, mac, tv, watch, vision, messages
Whether Apple marks the app as an Editors' Choice.
Apple's editorial note when it is an Editors' Choice.
Rating breakdown. Not available from the app lookup.
Average rating, rounded to one decimal as the App Store displays it; use the app route for the precise average. Null when nobody has rated.
Number of ratings in this storefront.
Ratings by stars. All zeros when nobody has rated.
Five-star ratings.
Four-star ratings.
Three-star ratings.
Two-star ratings.
One-star ratings.
Current chart rank; null when the app is not ranked.
Rank right now.
Chart category name.
Age rating on the current store tier, such as `4+` or `13+`.
Content descriptors behind the age rating.
Whether the app offers in-app purchases.
In-app purchases listed for the app (at most 10).
Purchase name.
Displayed price, in the storefront currency.
Top in-app purchases and subscriptions, when the App Store features them.
Purchase id.
Product identifier.
Purchase name.
What it unlocks.
Whether it is a subscription.
The version on sale; null when the app has none.
Version string.
Release time (ISO-8601, UTC).
Release notes.
Version history, newest first (at most 25).
Version string.
Release time (ISO-8601, UTC).
Release notes.
Privacy label the developer declared. Not in any lookup.
The developer's privacy policy.
The app's privacy label.
Stable id: `DATA_USED_TO_TRACK_YOU`, `DATA_LINKED_TO_YOU`, `DATA_NOT_LINKED_TO_YOU`, `DATA_NOT_COLLECTED` or `DATA_NOT_PROVIDED`.
Heading in the storefront language.
Explanatory text.
Categories of data.
Stable category id, e.g. `CONTACT_INFO` or `USAGE_DATA`.
Category name in the storefront language.
Named data types, e.g. `Email Address`.
Purposes, each with its data.
Stable purpose id, e.g. `ANALYTICS`.
Purpose name in the storefront language.
Data collected for this purpose.
Stable category id, e.g. `CONTACT_INFO` or `USAGE_DATA`.
Category name in the storefront language.
Named data types, e.g. `Email Address`.
Website and support links.
What the link is for.
one of: website, support, other
Link text in the storefront language.
Destination.
What each device needs to run the app.
Device name as printed, e.g. `iPhone`.
Requirement text.
Capabilities such as Game Center or SharePlay.
Stable id, e.g. `gameCenter`, `siri`, `sharePlay`.
Name in the storefront language.
Caption.
Accessibility features the developer declared.
The developer's page about the app's accessibility support, when it lists one.
Copyright line.
In-app events.
Event id.
Event title.
Event subtitle.
Event description.
Event type, e.g. `MAJOR UPDATE`.
Start (ISO-8601).
End (ISO-8601).
The reviews the App Store features for the app (about 8), with developer replies. For the full list use the reviews endpoint.
Review id.
Review title.
Review text.
Stars (1 to 5).
The reviewer.
Display name shown in the store.
When posted (ISO-8601, UTC).
The developer's reply, when there is one.
Reply id.
Reply text.
When replied (ISO-8601, UTC).
Similar apps.
App Store app id.
Bundle id.
App name.
Short tagline.
Developer name.
Average rating (0 to 5).
Rating count as the App Store displays it, e.g. `6.6K`.
Age rating such as `4+` or `13+`.
The app's App Store page.
More apps by the developer (up to 15). The developer endpoint is complete.
App Store app id.
Bundle id.
App name.
Short tagline.
Developer name.
Average rating (0 to 5).
Rating count as the App Store displays it, e.g. `6.6K`.
Age rating such as `4+` or `13+`.
The app's App Store page.
App Store stories that feature the app.
Story title.
Story label.
The story page.
Bundles the app is part of.
App Store app id.
Bundle id.
App name.
Short tagline.
Developer name.
Average rating (0 to 5).
Rating count as the App Store displays it, e.g. `6.6K`.
Age rating such as `4+` or `13+`.
The app's App Store page.
Screenshots by platform. Not all are in the app lookup.
iPhone screenshots.
iPad screenshots.
Mac screenshots.
Apple TV screenshots.
Apple Watch screenshots.
Vision Pro screenshots.
Messages screenshots.
Preview videos.
Platform the preview is for.
one of: iphone, ipad, mac, tv, watch, vision, other
HLS playlist of the preview video.
Poster image.
Poster width.
Poster height.
Per-platform record: ratings, age rating, chart positions, privacy purposes, requirements, tags and each platform's price, versions and media; null when it is temporarily unavailable or the app is not in this storefront.
Ratings in this storefront.
Average rating, rounded to one decimal as the App Store displays it; use the app route for the precise average. Null when nobody has rated.
Ratings in this storefront.
Ratings by stars.
Five-star ratings.
Four-star ratings.
Three-star ratings.
Two-star ratings.
One-star ratings.
Age rating and what it is based on.
Rating label such as `12+` or `13+`.
Numeric rating level.
Explanation Apple gives.
Content descriptors.
Current chart ranks; null where the app is not ranked.
Rank on the App Store.
`top-free` or `top-paid`.
Genre id.
Genre name.
Position in the chart.
Rank on the Messages App Store.
`top-free` or `top-paid`.
Genre id.
Genre name.
Position in the chart.
Privacy label the developer declared.
Where to manage privacy choices.
The privacy label.
Stable id, e.g. `DATA_LINKED_TO_YOU`.
Heading.
Explanatory text.
Categories of data.
Stable category id, e.g. `CONTACT_INFO` or `USAGE_DATA`.
Category name in the storefront language.
Named data types, e.g. `Email Address`.
Purposes, each with its data.
Stable purpose id, e.g. `ANALYTICS`.
Purpose name in the storefront language.
Data collected for this purpose.
Stable category id, e.g. `CONTACT_INFO` or `USAGE_DATA`.
Category name in the storefront language.
Named data types, e.g. `Email Address`.
What each device family needs.
Device family.
Requirement text.
Accessibility features by device family.
e.g. `APP_STORE`.
Whether the app is an Apple Arcade title.
Whether the app is a pre-order.
Game Center features, e.g. `achievements`.
Whether the iOS app also runs on Mac.
Genres.
Genre id.
Genre name.
Parent genre id.
Tags the store files the app under, e.g. `Friendship`.
Tag id.
Tag name.
The developer.
Developer id.
Developer name.
The developer's App Store page.
Whether the developer publishes apps.
Whether the developer publishes games.
In-app events.
Event id.
Event title.
Event subtitle.
Event description.
Event type, e.g. `MAJOR UPDATE`.
Start (ISO-8601).
End (ISO-8601).
When promotion starts (ISO-8601).
Event link.
Link into the app.
What the event needs.
One record per platform the app is sold on.
Platform this record is for.
one of: ios, mac, tv, watch, vision
Bundle id on this platform.
Seller on this platform.
Tagline on this platform.
Copyright line.
First release date on this platform (YYYY-MM-DD).
Store description on this platform.
Price on this platform in this storefront.
Price in the storefront currency.
Displayed price.
ISO 4217 currency code.
`get` for free apps, `buy` for paid.
Download size in bytes.
Lowest OS version that runs the app.
Requirements text, e.g. `Requires iOS 15.1 or later.`
Languages the app supports, with their language tags.
Language name.
Language tag.
Build id of the current version.
Version history, newest first, at most 25 per platform.
Version string.
Release time (ISO-8601, UTC).
Release notes.
Build id.
Developer links.
Developer website.
Support page.
Privacy policy.
Whether the app offers in-app purchases.
Capability flags the app declares, true ones only (e.g. `isGameCenterEnabled`, `isSiriSupported`).
Icon URL, 512 px.
Screenshot URLs by device bucket (e.g. `iphone6+`, `ipadPro_2018`, `appleTV`).
Preview videos.
Device bucket.
HLS playlist of the preview video.
Poster image.
Apple's editorial notes, when it wrote some.
Tagline.
Short editorial note.
Full editorial note.
Editorial badge, e.g. `Editors' Choice`.
Mac architecture support, on the Mac record.
Whether it runs on Apple silicon.
Whether it runs on Intel Macs.
Whether Rosetta is required.
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/details" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store app details.