APapptweak
App Category Ranking

App Category Ranking - History

Changed on

Returns historical rankings of an app in its main category & the category "All". <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/app for 1 day</th><th>Credits/app per extra day</th></tr></thead> <tbody> <tr><td><b>ranking</b></td><td>Hash containing the ranking of an app in the category in which it's present.</td><td>10</td><td>1</td></tr> </tbody> </table>

get/apps/category-rankings/history.json

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/apps/category-rankings/history.json
  • Auth
    API key in header x-apptweak-key

Query parameters

appsstring required

Comma-separated list of app IDs (max 5). <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank"><b>How to find App IDs?</b></a>

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'

Choose a device from iphone, ipad or android. Defaults to iphone.

start_datestring date

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

end_datestring date

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

Response

Successful response.

resultobject

Changes

  • a4af4000f1e3Revision changes
    • breaking

      for the query request parameter end_date, default value 2022-02-14 was removed

    • breaking

      for the query request parameter start_date, default value 2022-02-01 was removed

    • breaking

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

    • info

      api tag App Category Ranking 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