Skip to content

App demographics

The App demographics endpoint returns an array of monthly records. Discovery returns the same record fields in a result_rows array, with an optional next_page_token.

Attribute Description
app_id String, store-specific app ID.
country_iso String, country code.
year Integer, year of measurement.
month Integer, month of measurement, from 1 to 12.
female_pct Number, estimated female audience share.
male_pct Number, estimated male audience share.
avg_female_ratings Number or null, average rating associated with the female audience.
avg_male_ratings Number or null, average rating associated with the male audience.
total_reviews Integer, review count used in the demographic record.
pct Object mapping demographic segment keys to numeric audience estimates.
ratings Object mapping demographic segment keys to numeric rating estimates.

Segment keys can include age_11_to_20, age_21_to_30, and gender-specific keys such as age_21_to_30_female. Alternative segment definitions can use an _rfp suffix. Available keys vary by record; do not assume every age/gender combination is present.