---
title: "Creators behind a cohort cell"
method: GET
path: "/cohorts/creators"
tags: ["Cohort Analysis"]
---

# Creators behind a cohort cell

`GET /cohorts/creators`

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.

## Query parameters

- `cohort_month` string, date, required — Cohort start month (YYYY-MM-01).
- `offset` integer, required — Months since start (M0..M6).
- `metric` string — Which cell was clicked: 'posting' or 'gmv'.
- `direction` string — 'active' (qualified) or 'lapsed' (re-engagement targets).
- `product_id` string, nullable — Optional product filter (match the grid).

## Response `200`

Successful Response

- CohortCreatorsResponse — Creators behind a single clicked cell (cohort × offset × metric).
  - `creators` CohortCreator[]
    - `creator_key` string, required
    - `creator_display_name` string, nullable
    - `videos_posted` integer
    - `gmv` string
  - `capped` boolean — True when the result hit the row cap and was truncated.
  - `cap` integer — Max rows returned; results truncated beyond this.
  - `direction` string — 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.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/d4fe3e380424/schema)