iOS Apps

Rankings History

Ranking history for an app in a given ranking list.

Observations are ordered newest first.

Required permissions for your API key's user: appstore.apps.

get/appstore/apps/{app_id}/rankings-history

Request

app_idstring required

Apple App Store ID (numeric) or bundle ID: id or bundle_id from /appstore/apps.

containerstring required

Chart type identifier from /appstore/rankings.

genrestring required

App category identifier from /appstore/rankings; ios includes all apps.

countrystring required

Country slug from /appstore/rankings, for example us.

beforestring date

Include observations on or before this UTC date (inclusive).

offsetinteger

Offset the set of results to return. Useful for paging through results.

page_sizeinteger

Number of results to return.

Successful response.

{
  "total": 1,
  "page_size": 4,
  "results": [
    {
      "ranking": 194,
      "date": "2026-09-27 13:12:04"
    }
  ]
}

No recorded changes to this operation across all 1 revision of this API.