Skip to main content
GET
Top Charts
Top charts for a storefront, for iPhone or iPad, optionally scoped to a single genre. rank is the app’s position in the feed — Apple sends no explicit rank field. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
default:"us"
Storefront code, lowercase ISO 3166-1 alpha-2. See /markets.
string
default:"top-free"
top-free, top-paid or top-grossing.
integer
Genre id to scope the chart, e.g. 6014 (Games). Omit for the overall chart. Only ids from /genres are accepted — every one of them is verified to return a non-empty chart.
integer
default:"50"
Entries to return, 1200.
string
default:"apps"
apps (iPhone) or ipad.

Response

string
string
The chart type returned.
string
apps or ipad.
integer
The genre scope, or null for the overall chart.
integer
Entries returned.
ChartEntry[]

Example

Response

Errors