Social Fetch
Start for freeStart free
Apple App Store hub

Apple App Store Charts API

Top free, paid, grossing and new charts by storefront, platform and genre, with the app record kept on every rank.

GET /v1/apple-app-store/charts

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/apple-app-store/charts takes a country storefront, a chart, a platform, a genre id and a limit. chart is top-free, top-paid, top-grossing, new, new-free or new-paid. platform is iphone, ipad or mac. genre defaults to 36 for all apps, and 6014 is Games. The response is data.lookupStatus, data.storefront, data.chart, data.platform, data.genreId and data.entries.

Each entry has rank, id and app. app is the same full app record the app route returns, and it is null when that app's record is unavailable, but the rank and id stay in place. top-free and top-paid return up to 200 ranks on iPhone, iPad and Mac. top-grossing returns up to 100 and is available on iPhone and iPad. new, new-free and new-paid return up to 100 and are available on iPhone. The default limit is 100. Charts are the heaviest route: above roughly 3 requests a second the API may answer 503 instead of queueing work that cannot finish, so retry with backoff.

Apple App Store Charts API FAQ

Which charts can I request?

top-free and top-paid on iphone, ipad and mac; top-grossing on iphone and ipad; new, new-free and new-paid on iphone. The contract refuses a chart and platform pair that Apple does not publish.

How do I pick a genre?

Pass the genre id in genre. 36 is all apps and 6014 is Games. Other category ids such as 6005 for Social Networking work on the platforms that publish that chart. The response echoes the id in genreId.

Why is entries[].app null?

That app's record is unavailable in this storefront. The entry keeps its rank and id so the chart still lines up, and you can retry the app on its own route later.

How many ranks come back?

limit defaults to 100. top-free and top-paid accept up to 200. top-grossing and the new charts accept up to 100, because those charts stop there.

Why would a chart request answer 503?

Charts are much heavier than the other routes. Above roughly 3 requests a second the API sheds work with a 503 instead of holding requests that would miss their deadline. Retry with backoff, lower your concurrency, or request fewer ranks.

How many credits does a chart cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Apple App Store endpoints