Store top charts
Try this endpoint · Response fields
Consider the example request for iOS Overall free ranks in US on 4/29/2015:
curl -X "GET" "https://integrations.apptopia.com/api/itunes_connect/rank_lists?id=36&date=2015-04-29&kind=free&country_iso=US" \ -H "Authorization: $APPTOPIA_TOKEN"Example response:
// Abbreviated response; omitted fields and records are shown as ... [ { "date": "2015-04-29", "country_iso": "US", "kind": "free", "category_id": 36, "app_ids": [ 454638411, 284882215, 389801252, ... ] } ]Top charts are represented by arrays of app ids. Apps are ordered from top to bottom: from rank 1 to the lowest available rank.
Response fields
Section titled “Response fields”Each response record describes a chart:
| Field | Description |
|---|---|
date |
String, measurement date in YYYY-MM-DD format. |
country_iso |
String, country code. |
kind |
String, chart kind such as free, paid, or grossing. |
category_id |
Integer, store-specific category ID. |
app_ids |
Array of app IDs in rank order: integers for Apple App Store, package-name strings for Google Play. |
Endpoint path: /api/:store/rank_lists
Query parameters
Section titled “Query parameters”| Param | Description |
|---|---|
id |
int, store specific category id |
date |
string date in iso8601 format, e.g. “2016-05-12” |
country_iso |
string, ISO 3166 A2 country code |
kind |
string, chart kind: “free”, “paid” or “grossing” |