App Metrics

App Metrics - History

Changed on

Get the historical 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 for 1 day</th><th>Credits/app per extra day</th></tr></thead> <tbody> <tr><td><b>downloads</b></td><td>Hash containing the value of 1st time download estimates, its precision and the date.</td><td>500</td><td>50</td></tr> <tr><td><b>revenues</b></td><td>Hash containing the value of daily revenue estimates, its precision, the currency and the date.</td><td>500</td><td>50</td></tr> <tr><td><b>ratings</b></td><td>The total number of 1, 2, 3, 4, and 5 stars ratings, the total number of ratings, and the average score of the app.</td><td>10</td><td>1</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><td>1</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><td>1</td></tr> </tbody> </table> <Callout icon="🚧" theme="warn"><b>Missing app ratings data?</b><p>If you're not seeing some data that is appearing on the store, it's probably because the app is not followed and we haven't fetched data for it. You should make sure to follow the app through our ASO tool to ensure its data is fetched daily.</p></Callout>

get/apps/metrics/history.json

Request

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

metricsstring required

Comma separated list of metrics.

start_datestring date

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

end_datestring date

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

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. You can only pass one country code. 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

    • breaking

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

    • breaking

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

    • breaking

      for the query request parameter end_date, default value 2022-02-03 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 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