Cohort Analysis

Creators behind a cohort cell

Changed on

Drill-down for one clicked cell (cohort × offset): the creators it represents. direction=active returns the creators who qualified at that offset (the cell's numerator); direction=lapsed returns the cohort members who did NOT — the re-engagement target list. Capped at 500 rows (capped flags truncation). Single-shop only.

get/cohorts/creators

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/cohorts/creators
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

cohort_monthstring date required

Cohort start month (YYYY-MM-01).

offsetinteger required

Months since start (M0..M6).

metricstring

Which cell was clicked: 'posting' or 'gmv'.

directionstring

'active' (qualified) or 'lapsed' (re-engagement targets).

product_idstring nullable

Optional product filter (match the grid).

Response

Successful Response

cappedboolean

True when the result hit the row cap and was truncated.

capinteger

Max rows returned; results truncated beyond this.

directionstring

Which half of the cell this list is: 'active' (creators who qualified at that offset) or 'lapsed' (cohort members who did not). Echoed back so the FE cannot mislabel the list.

Changes

    • info

      the // response's property pattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ was removed for the status

    • info

      api operation id cohort_cell_creators_cohorts_creators_get removed and replaced with cohort_cell_creators