Skip to content

Store top charts

Try this endpoint · Response fields

Consider the example request for iOS Overall free ranks in US on 4/29/2015:

Terminal window
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.

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

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”