> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt). ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** --- # 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` 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. ## Request - **Endpoint:** `GET /v1/apple-app-store/charts` - **Credits:** 1 credit Failed requests are free - **Input:** by chart and category - **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/apple-app-store/charts/get) - **Platform page:** [/platforms/apple-app-store](https://www.socialfetch.dev/platforms/apple-app-store) ## 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.