APapptweak
Top Charts

Top Charts - Current

Changed on

Returns the most recent top chart for the App Store or Google Play Store. The top 500 applications are available for free, paid, or grossing apps. <br/><br/> You can find historical top apps in the History section. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits</th></tr></thead> <tbody> <tr><td><b>-</b></td><td>List of app IDs of 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></tr> </tbody> </table>

get/charts/top-results/current.json

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/charts/top-results/current.json
  • 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>.

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. Defaults to iphone.

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 gr to us

    • breaking

      for the query request parameter device, default value was changed from android to iphone

    • 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

      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