Get many Apple App Store apps
Get up to 200 Apple App Store apps in one request.
Headers
Get your API keyAPI key (`sfk_...`)
An App Store link, numeric app id or bundle id. Repeat `url` for each app, up to 200. A repeated id or bundle id is billed once; an id and its bundle id are separate references. Every app is looked up in `country`.
Two-letter App Store storefront (country) code, e.g. `us`, `gb`, `jp`. Every app in the request is looked up in this storefront, whatever storefront a pasted link names. 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.
Storefront (country) the records are for.
One row per unique requested reference, in request order.
The app reference as sent.
Whether the reference was taken as an app id or a bundle id.
one of: id, bundle_id
`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
The app; null when not found in this storefront.
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.
Counts for the batch.
Unique app references requested.
App references found.
App references not found in this storefront.
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?url=284882215" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store batch lookup.