List Apple App Store charts
List Apple App Store charts with full app records.
Headers
Get your API keyAPI key (`sfk_...`)
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}$
`top-free`, `top-paid`, `top-grossing`, `new`, `new-free` or `new-paid`. `top-grossing` is available on iPhone and iPad; the `new` charts on iPhone only. Default: `top-free`.
one of: top-free, top-paid, top-grossing, new, new-free, new-paid
`iphone`, `ipad` or `mac`. Default: `iphone`.
one of: iphone, ipad, mac
Genre id to rank within, e.g. `6014` for Games or `6005` for Social Networking. Default: `36`, all apps.
≥ 1 · ≤ 9999
Ranks to return, 1-200 (1-100 for top-grossing and the new charts). Default: 100.
≥ 1 · ≤ 200
Endpoint-specific response payload.
`not_found` when the storefront has no such chart.
one of: found, not_found
Storefront the chart is for.
The chart returned.
one of: top-free, top-paid, top-grossing, new, new-free, new-paid
Platform.
one of: iphone, ipad, mac
Genre id of the chart.
Chart positions in rank order.
Position in the chart, from 1.
≥ 1
App Store app id.
The app record; null when the app's record is unavailable in this storefront. The rank is kept.
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/charts?chart=top-free&platform=iphone" \
-H "x-api-key: YOUR_API_KEY"Responses
App Store chart.