Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Category Ranking - History

Returns historical rankings of an app in its main category & the category "All".

get/apps/category-rankings/history.json

Query parameters

appsstring required

Comma separated list of app IDs. Max 5 apps are allowed. <br/> <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank">How to find App IDs?</a>

countrystring

Two letter country code

device'iphone' | 'ipad' | 'android'

The device you want to fetch the top chart for: iphone, ipad or android

start_datestring date

Start date of the period in format YYYY-MM-DD<br/><b>Default:</b> 30 days ago

end_datestring date

End date of the period in format YYYY-MM-DD<br/><b>Default:</b> yesterday

Response

200

OR

Example response

{
  "result": {
    "1313192037": {
      "rankings": [
        {
          "value": [
            {
              "rank": 436,
              "fetch_date": "2022-06-01",
              "category": "0",
              "category_name": "All",
              "chart_type": "free",
              "fetch_depth": 500
            }
          ],
          "date": "2022-06-01"
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/charts-rankings/history.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "start_date": "2022-06-01",
        "end_date": "2022-06-03",
        "apps": [
          "1313192037"
        ]
      },
      "cost": 11,
      "max_credit_cost": 13,
      "status": 200
    }
  }
}