Skip to content

Category retention

The Category retention endpoint returns an array of monthly category records. Discovery places the same record fields in result_rows, with an optional next_page_token.

Attribute Description
category_id Integer, store-specific category ID.
country_iso String, country code.
year Integer, year of measurement.
month Integer, month of measurement, from 1 to 12.
avg Object containing average retention values by day.
avg_top10_pct Object containing top-10-percent average retention values by day.
percentile_10 Object containing 10th-percentile retention values by day.
percentile_90 Object containing 90th-percentile retention values by day.

Each statistics object maps day keys such as day1, day7, day14, and day30 to numbers. Available day keys can vary.