APapptweak
App Metrics

App Metrics - Current

Changed on

Get the most recent metrics of an app (downloads, revenues, ratings & app power). <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/app</th></tr></thead> <tbody> <tr><td><b>downloads</b></td><td>Array of numbers listing all the download estimates for each day on the selected period.</td><td>500</td></tr> <tr><td><b>revenues</b></td><td>Array of numbers (integer) listing all the revenues estimates for each day on the selected period.</td><td>500</td></tr> <tr><td><b>ratings</b></td><td>The total number of 1, 2, 3, 4, and 5 stars ratings and the average score of the app.</td><td>10</td></tr> <tr><td><b>daily-ratings</b></td><td>The total number of new 1, 2, 3, 4, and 5 stars ratings and the average score of the app for the day.</td><td>10</td></tr> <tr><td><b>app-power</b></td><td>The App Power indicates the power of the app based on its rankings in its specific category and in the overall category.</td><td>10</td></tr> </tbody> </table>

get/apps/metrics/current.json

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/apps/metrics/current.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>

metricsstring required

Comma separated list of metrics (e.g. downloads,ratings).

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.

languagestring

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: <a href="https://developers.apptweak.com/reference/languages-1" target="_blank"><code>GET /api/public/apptweak/languages</code></a> with store=ios or store=android. These metrics do not vary by language: the value is checked against the country and then not used. Defaults to the country's <a href="https://developers.apptweak.com/reference/languages-overview#default-language" target="_blank"><b>default language</b></a>.

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

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

Response

Successful response.

resultobject

Changes

  • a4af4000f1e3Revision changes
    • breaking

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

    • info

      api tag App Metrics added

    • info

      added the new optional query request parameter language

    • info

      removed subschema #1: VIEW EXAMPLE iOS subschema #2: VIEW EXAMPLE 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