App Metrics - History

get

https://public-api.apptweak.com/api/public/store/apps/metrics/history.json

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

Price

Data	Credits	Per
Ratings	5	app and metric
Daily ratings	5	app and metric
App Power	5	app and metric
Download estimates	50	app and metric
Revenue estimates	50	app and metric

Any date range up to 1 year costs the same.

Metrics returned as null are still charged.

Requesting downloads or revenues requires estimates access. Existing plans retain access; new Lite, Pro and Power plans do not include it.

🚧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

apps

string

required

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

metrics

string

required

Comma separated list of metrics.

start_date

date

Start date (YYYY-MM-DD). Send both dates or omit both. Maximum range: one full calendar year. Defaults to 30 days ago.

end_date

date

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

country

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.

language

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.

device

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.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response.

403NotEnoughCreditsError: insufficient credits. EstimatesNotInPlanError: estimates access is missing. Either error rejects the whole request at no charge.

422Validation error. Returned when a parameter is invalid (free), or with the code AppNotAvailableError when a requested app is not available in the country, language and device (costs 1 credit).