App Metrics - History
Changed onGet 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>
Request
- Base URLhttps://public-api.apptweak.com/api/public/store
- URLhttps://public-api.apptweak.com/api/public/store/apps/metrics/history.json
- AuthAPI key in header x-apptweak-key
Query parameters
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>
Comma separated list of metrics.
Start date (YYYY-MM-DD). Defaults to 30 days ago.
End date (YYYY-MM-DD). Defaults to yesterday.
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.
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>.
Choose a device from iphone, ipad or android. Defaults to iphone.
Response
Successful response.
Changes
- breaking
for the
queryrequest parametercountry, default value was changed fromfrtous - breaking
for the
queryrequest parameterdevice, default value was changed fromandroidtoiphone - breaking
for the
queryrequest parameterend_date, default value2022-02-03was removed - breaking
for the
queryrequest parameterstart_date, default value2022-02-01was removed - breaking
the response's body type changed from no type to
objectfor status - info
api tag
App Metricsadded - info
added the new optional
queryrequest parameterlanguage - info
removed
subschema #1: VIEW EXAMPLE iOSsubschema #2: VIEW EXAMPLE ANDROIDfrom the response bodyoneOflist 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
- breaking