REreacherapp
Cohort Analysis

Resolve a cohort/repost segment to creator handles

Changed on

Resolves a segment — a cohort cell (source=cohort_cell) or a repost bucket set (source=repost) — to the underlying creator handles, for exporting or piping into outreach. Single-shop only.

get/cohorts/segment

Request

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

Query parameters

sourcestring required
cohort_monthstring date nullable

cohort_cell only: cohort start month.

offsetinteger nullable

cohort_cell only: month offset.

metricstring
directionstring
bucketsstring nullable

repost only: comma-separated bucket keys.

window_daysinteger

repost only: recency window.

Response

Successful Response

handlesstring[]
totalinteger

Creators matched by the segment.

resolvedinteger

Of those, how many resolved to a handle.

unresolvedinteger

Matched creators with no resolvable handle — they cannot go into a creator list. Surfaced so the UI states the real audience size instead of quietly shipping a shorter one.

cappedboolean

True when the segment hit the handle cap.

capinteger

Max handles returned.

Changes