Sign in
Cohort Analysis

Resolve a cohort/repost segment to creator handles

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

Query parameters

sourcestring required
cohort_monthstring date nullable

cohort_cell only: cohort start month.

cohort_cell only: cohort start month.

offsetinteger nullable

cohort_cell only: month offset.

cohort_cell only: month offset.

metricstring
directionstring
bucketsstring nullable

repost only: comma-separated bucket keys.

repost only: comma-separated bucket keys.

window_daysinteger

repost only: recency window.

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

No recorded changes to this endpoint across all 1 revision of this API.