Skip to content

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”.