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.