App Metrics

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 NameDescriptionOriginHistorical Data Available?
downloadsThe daily number of downloads generated the applicationAppTweak estimation
revenuesThe daily revenues generated by the applicationAppTweak estimation
app-powerA number between 1 and 100 indicating how visible and popular the application is.
Higher is better.
AppTweak-defined KPI
ratingsA number between 1 and 5 indicating how many users like this application.
Higher is better.
Gathered directly from the app store pages
daily-ratingsA 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"
      }
}

For the metrics downloads and revenues, a precision field is present. It can have three different values:

  • 0.85 -- accurate. We have a lot of real data points for the given category/country/ranking tier. We guarantee that our estimates are highly accurate in this case. They should reflect very well the real number of downloads and/or revenue of this app you’re looking at.
  • 0.6 -- fair. We have a fair amount of real data points for the given category/country/ranking tier. Although you still need to be careful while interpreting the data provided, these most likely have a good correlation with the exact data.
  • 0.25 -- moderate. We don’t have a lot of real data points for the given category/country/ranking tier. It’s a rough estimation, that is more useful in terms of comparison between apps rather than providing an actual number of downloads or revenue.

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
}