Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

Top Charts - History

Returns historical top charts for the App Store or Google Play Store. The top 500 applications are provided for free and paid, or grossing apps.

get/charts/top-results/history

Query parameters

categoriesstring required

The category id for which you want to get the top charts. Find <a href="https://apptweak.readme.io/reference/app-store-categories" target="_blank">App Store Categories</a> and <a href="https://apptweak.readme.io/reference/google-play-store-categories" target="_blank">Google Play Store Categories</a>

start_datestring

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

end_datestring

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

types'free' | 'paid' | 'grossing'

Chart type: free, paid or grossing. <br/><b>Default:</b> free

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

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

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

limitinteger

The number of apps you want to fetch. <b>Max limit is 500</b>. <br/><b>Default:</b> 100

offsetinteger

The index by which you would like to offset the top chart. <br/><b>Default:</b> 0.

Response

200

OR

Example response

{
  "result": {
    "7013": {
      "free": [
        {
          "date": "2022-06-01",
          "value": [
            1599121822
          ]
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/charts/top-results/history",
      "params": {
        "device": "iphone",
        "country": "in",
        "limit": 50,
        "start_date": "2022-06-01",
        "end_date": "2022-06-02",
        "categories": [
          "7013"
        ],
        "types": [
          "free"
        ]
      },
      "cost": 12,
      "max_credit_cost": 12,
      "status": 200
    }
  }
}