App Ratings
The App ratings endpoint returns ratings, rating counts, and their breakdowns over a date range.
| Attribute | Description |
|---|---|
id |
string in lookups; Apple App Store IDs can be integers in discovery and bulk exports. Google Play IDs are package-name strings. |
country_iso |
string, country code |
date |
date, day of measurement |
avg_rating |
double, average rating |
ratings_count |
long, total number of ratings |
ratings_breakdown |
map, breakdown of ratings, e.g: {"1": 0, "2": 0, "3": 1, "4": 100, "5": 300} |
iTunes App Store specific attributes:
| Attribute | Description |
|---|---|
current_version_avg_rating |
double, average rating for current version (on date) |
current_version_ratings_count |
long, number of ratings for current version (on date) |
current_version_ratings_breakdown |
map, breakdown of ratings for current version (on date) |
Note that Apple App Store exposes ratings on per country basis, and Google Play exposes only global ratings metrics. There’s only one country_iso value for Google Play: “WW”.