App Metrics - History

Get the historical metrics of an app (downloads, revenues, ratings & app power).

Price

DatapointDescriptionCredits/app for 1 dayCredits/app per extra day
downloadsHash containing the value of 1st time download estimates, its precision and the date.50050
revenuesHash containing the value of daily revenue estimates, its precision, the currency and the date.50050
ratingsThe total number of 1, 2, 3, 4, and 5 stars ratings, the total number of ratings, and the average score of the app.101
daily-ratingsThe total number of new 1, 2, 3, 4, and 5 stars ratings and the average score of the app for the day.101
app-powerThe App Power indicates the power of the app based on its rankings in its specific category and in the overall category.101
đźš§Missing app ratings data?

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.

Query Params
string
required

Comma-separated list of app IDs (max 5). How to find App IDs?

string
required

Comma separated list of metrics.

date

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

date

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

string
Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. You can only pass one country code. Defaults to us.

string

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: GET /api/public/apptweak/languages 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 default language.

string
enum
Defaults to iphone

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

Allowed:
Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Not enough credits to perform the request.

422

Validation error. Returned when a parameter is invalid.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json