List top chart apps (v1)
Returns up to 100 apps from an App Store chart in rank order: top free, paid or grossing for iPhone or iPad, or new apps, in any storefront, optionally for one genre. Grossing, iPad, new and genre charts also carry price and summary.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
country?string
App Store storefront, as a two-letter country code.
Match
^[A-Z]{2}$Default
"US"chart?string
top-free, top-paid, top-grossing, the same three for iPad (top-free-ipad ...), or new for new apps.
Default
"top-free"Value in
- "top-free"
- "top-paid"
- "top-grossing"
- "top-free-ipad"
- "top-paid-ipad"
- "top-grossing-ipad"
- "new"
genre?string
App Store genre id, such as 6014 Games, 6015 Finance or 7014 Role Playing. Omit for all apps.
limit?integer
Maximum ranked apps to return.
Range
1 <= value <= 100Default
100curl -X GET "https://example.com/v1/app-store/charts" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "country": "string", "chart": "top-free", "genre": "string", "apps": [ { "rank": 0, "app_id": "string", "name": "string", "developer_id": "string", "developer_name": "string", "release_date": "string", "kind": "string", "artwork_url": "string", "genres": [ { "genre_id": "string", "name": "string", "url": "string" } ], "app_store_url": "string", "price": 0, "currency": "string", "summary": "string" } ] }, "details": { "reason": "no_results", "message": "string" }}