App Metrics - Current

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

Price

DataCreditsPer
Ratings1app and metric
Daily ratings1app and metric
App Power1app and metric
Download estimates10app and metric
Revenue estimates10app and metric


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

Query Params
string
required

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

string
required

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

string
Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. 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

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

422

Validation 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).

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