APapptweak
Top Charts

Top Charts - History

Changed on

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. <br/><br/> You can find the most recent top apps in the Current section. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits for 1 day</th><th>Credits per extra day</th></tr></thead> <tbody> <tr><td><b>-</b></td><td>List of app IDs in the top chart. The list is ordered in ascending order meaning that the first element in the list is the top app.</td><td>10</td><td>1</td></tr> </tbody> </table>

get/charts/top-results/history

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/charts/top-results/history
  • Auth
    API key in header x-apptweak-key

Query parameters

categoriesstring required

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

start_datestring date

Start date (YYYY-MM-DD). Defaults to 30 days ago.

end_datestring date

End date (YYYY-MM-DD). Defaults to yesterday.

typesstring required

Comma-separated chart types among free, paid and grossing (free,paid asks for both). Each type is one datapoint per category.

countrystring

Two-letter country code (us, gb, fr). Accepted values: <a href="https://developers.apptweak.com/reference/countries-1" target="_blank"><code>GET /api/public/apptweak/countries</code></a> with store=ios or store=android. Defaults to 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 (max 500). Defaults to 100.

offsetinteger

The index by which you would like to offset the top chart. Defaults to 0.

Response

Successful response.

resultobject

Changes

  • a4af4000f1e3Revision changes
    • breaking

      the query request parameter types became required

    • breaking

      for the query request parameter limit, default value 100 was added

    • breaking

      for the query request parameter offset, default value 0 was added

    • breaking

      for the query request parameter country, default value was changed from in to us

    • breaking

      for the query request parameter end_date, default value 2021-12-31 was removed

    • breaking

      for the query request parameter start_date, default value 2021-12-15 was removed

    • breaking

      removed the enum value free from the query request parameter types

    • breaking

      removed the enum value grossing from the query request parameter types

    • breaking

      removed the enum value paid from the query request parameter types

    • breaking

      for the query request parameter end_date, the format changed from no format to date

    • breaking

      for the query request parameter start_date, the format changed from no format to date

    • breaking

      the response's body type changed from no type to object for status

    • info

      api tag Top Charts added

    • info

      removed subschema #1: iOS subschema #2: Android from the response body oneOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status