Returns analytics data for applications that AppTweak has been able to gather or estimate.
Application metrics are numerical properties that AppTweak has been able to gather or estimate about applications. Metrics are exposed through two endpoints:
- The Current endpoint which returns the latest - most recent - data available
- The History endpoint which returns the historical daily values over a given period of time
Input values
The App Metrics endpoints take the following query parameters into account: apps, metrics, country
, device, start_date and end_date. The date parameters only apply to App Metrics - History. You can find more information about the query parameters directly in the API endpoint definition.
See the table below for the list of available metrics.
| Metric Name | Description | Origin | Historical Data Available? |
|---|---|---|---|
| downloads | The daily number of first time downloads generated the application | AppTweak estimation | ✅ |
| revenues | The daily revenues generated by the application. Including app or in-app purchases. | AppTweak estimation | ✅ |
| app-power | A number between 1 and 100 indicating how visible and popular the application is. Higher is better. | AppTweak-defined KPI | ✅ |
| ratings | The total number of 1, 2, 3, 4; and 5 stars ratings and the average score of the app. | Gathered directly from the app store pages | ✅ |
| daily-ratings | A number between 1 and 5 indicating how many users like this application. Higher is better. Shows the new ratings for the day. | Gathered directly from the app store pages | ✅ |
All metrics are available for both iOS and Android applications.
Response format
The response will be a JSON grouped by app ID and metric. For each metric the response will contain a hash (for App Metrics - Current) or a list of hashes (for App Metrics - History). The content of the hash is specific to each metric. You will find the content for each metric listed below.
downloads
"downloads": {
"value": <int>, // number of estimated daily 1st time downloads
"date": <string>, // date in YYYY-MM-DD format
"precision": <float> // indicator for the accurancy of our estimates
}
}revenues
"revenues": {
"value": <int>, // number of estimated revenues in USD
"date": <string>, // date in YYYY-MM-DD format
"precision": <float> // indicator for the accurancy of our estimates
"currency": "USD"
}
}
Precision field is deprecated since March 2023Our new algorithm released in March 2023 doesn't take into consideration the
precisionindicator anymore. This field can therefore be ignored.
ratings
The total number of 1, 2, 3, 4, and 5 stars ratings, the total number of ratings, and the average score of the app as it appears on the store app page.
"ratings":
{
"value": <float>, // average rating for the app
"breakdown": {
"1": <int>, // total number of 1 star ratings
"2": <int>, // total number of 2 star ratings
"3": <int>, // total number of 3 star ratings
"4": <int>, // total number of 4 star ratings
"5": <int>, // total number of 5 star ratings
"total": <int>, // total number of ratings
"avg": <float> // average rating for the app
},
"date": <string> // date in YYYY-MM-DD format
}daily-ratings
The total number of new 1, 2, 3, 4; and 5 stars ratings and the average score of the app for the day. Negative values for the number of star ratings means that either users deleted their rating or the Apple or Google deleted ratings. The average rating takes only newly added ratings into account.
"daily-ratings":
{
"breakdown": {
"1": <int>, // number of new 1 star ratings
"2": <int>, // number of new 2 star ratings
"3": <int>, // number of new 3 star ratings
"4": <int>, // number of new 4 star ratings
"5": <int> // number of new 5 star ratings
},
"date": <string> // date in YYYY-MM-DD format
"value": <float> // average rating of the based on the new ratings.
}app-power
The "App Power" is a KPI (Key Performance Indicator) that shows the overall performance of an app in the store. The App Power is built on a scale from 0-100, 100 being the highest score and 0 the lowest. A high App Power means that an app is performing well in the given country and that it probably has a high download rate.
The App Power is country and store specific, which means that the same app can have different App Powers in different countries (typically if it is performing well in a country and not so well in another).
"app-power":
{
"value": <int>,
"date": <string> // date in YYYY-MM-DD format
}Data overview
What do we predict?
Downloads:
- IOS: First-time downloads (previously App Units) → when a user downloads your app to their device for the first time, not including re-downloads
- Android: Unique Device Installs
Revenue:
- iOS: Sales metric from the Itunes Connect Console
- Android: Revenue estimates include all purchases that go through the stores (in-app purchases, paid apps, ...). So it includes renewed subscriptions as long as they go through the stores.
Extra information for Apple Sales :
→ Apple’s console proceeds correspond to the estimated amount of proceeds you will receive from your sales. This is the Customer Price minus applicable taxes and Apple’s commission, per Schedule 2 of the Paid Applications Agreement.. Sales therefore correspond to the whole amount before the commission.
Estimation windowWe can only compute downloads estimates if the app is ranked in the top 500 for IOS and 200 for Android within a -7 /+3 days from the considered day, as 500 for IOS and 200 for Android was the lowest rank possible at the time we trained the model.
Therefore estimations can vary slightly up to 7 days after the first estimation.
Note: We were able to compute the top 500 for IOS and Android before. However, on the 24th February Google decided to show until the top 200.
How do we compute the download and revenue estimates?
To calculate our download estimates, we use various indicators such as:
- Category rank: The rank of an app in its category (free or paid) gives an indication of the level of daily downloads that the app is making. Of course, each category and country has its own level of competitiveness. Download estimates are based on the category ranking of an app in the Free or Paid Top Charts and Revenue estimates are based on category ranking of an app in the Grossing Top Charts.
- Seasonality: Seasonality and specific events can highly affect app downloads. The impact depends on various elements such as the apps’ type, the country, and the event itself. These subtleties are captured by our estimates model.
- A broad range of data: With the help of deep learning, our model uses a broad range of data to compute estimates, which results in a higher level of accuracy. More info on how we use deep learning in this blog post.
Why doesn’t AppTweak give download / revenue estimates for my app?
- We only have category ranks up to 500 for Apple and up to 200 for Google → Our algorithms were only trained on apps that rank in the top 500 for Apple and top 200 for Google results, therefore, since download estimates heavily depend on category rank, they cannot be predicted for apps that don’t rank within the top 500 for Apple and top 200 for Google (estimates will be 0).
- Do we always have non-zero data for apps that are ranking in the Top 200/500 of Top Charts? No, in small countries / small categories, you can find apps at the bottom of the top 200 for which we predict 0 downloads!
- For revenue estimates, we look at the app’s rank in the Top Grossing Charts, therefore, we cannot predict revenue estimates for apps that don’t rank within the top grossing 500 for Apple and top grossing 200 for Google (estimates will be 0).
FAQs
Can I fetch app download and revenue data via API?
Yes — you can fetch an app's most recent download and revenue estimates with AppTweak's App Store API, specifically the App Metrics - Current endpoint (GET /apps/metrics/current.json). Pass up to 10 app IDs in apps and downloads,revenues in metrics, plus optional country (default us) and device (iphone, ipad, or android). The response returns each metric's latest value and date, with revenues also including the currency.
Which app ratings and reviews API returns an app's current star rating breakdown?
AppTweak's App Metrics - Current endpoint returns the full 1-to-5-star rating breakdown for any app, not just its review text. It returns a breakdown object with counts per star (1 through 5), a total count, and the average score, as of the most recent fetch date. Request it by passing ratings in metrics alongside the target apps. Pair it with the App Reviews API for the actual review text and sentiment.
What's the difference between ratings and daily-ratings in the App Metrics API?
The difference is scope: ratings returns the app's all-time rating totals, while daily-ratings returns only the ratings received on that specific day. Request them as ratings and daily-ratings in metrics; both return the same star-by-star breakdown and average score, at 10 credits per app. Use ratings for an app's overall standing and daily-ratings to track new rating volume day by day.
What parameters do the App Metrics endpoints accept?
AppTweak's App Metrics endpoints accept apps (required, comma-separated app IDs — max 10 for Current, max 5 for History), metrics (required, comma-separated list from downloads, revenues, ratings, daily-ratings, app-power), country (two-letter code, default us), and device (iphone, ipad, or android, default iphone). History additionally accepts start_date and end_date (default: the last 30 days). Authenticate with the x-apptweak-key header against https://public-api.apptweak.com/api/public/store.
How many credits does an app metrics API call cost?
Cost depends on which metrics are requested and, for History, over how many days. Downloads and revenue cost 500 credits per app on Current, or 500 credits for the first day plus 50 credits per extra day on History. Ratings, daily ratings, and App Power cost 10 credits per app on Current, or 10 credits plus 1 credit per extra day on History.
How do I build an app performance dashboard with download, revenue, and rating trends?
You can feed a BI dashboard with day-by-day app download, revenue, rating, and App Power history using AppTweak's App Store API, specifically the App Metrics - History endpoint (GET /apps/metrics/history.json). Set start_date and end_date and pass any combination of downloads, revenues, ratings, daily-ratings, app-power in metrics for up to 5 apps per call — each metric returns as a dated array ready to load into Tableau, Power BI, Looker Studio, or a spreadsheet.
How do I monitor a competitor's app downloads and ratings over time?
You can track a competitor's download, revenue, rating, and App Power trends with AppTweak's App Store API, specifically the App Metrics - History endpoint. Query the competitor's app ID with a date range and the metrics you want to watch; each comes back as a daily series, so a scheduled call (for example through n8n) can flag notable jumps in downloads or rating score without manual checking.
Can I fetch historical app metrics for both iOS and Android from one endpoint?
Yes — one endpoint covers both stores: the App Metrics - History endpoint accepts a device parameter (iphone, ipad, or android) alongside a single country code per call. App IDs differ by store (numeric for iOS, package name like com.example.app for Android), and you can query up to 5 apps per call, but each call covers one device and one country at a time.
What's the difference between App Metrics - Current and App Metrics - History?
The difference is timing: Current returns an app's latest metric snapshot, while History returns a day-by-day series over a date range. Current (GET /apps/metrics/current.json) gives the most recent downloads, revenue, ratings, daily ratings, and App Power values for up to 10 apps, while History (GET /apps/metrics/history.json) gives the same metrics as arrays across a date range for up to 5 apps. Use Current for today's state, History to see trends.