---
title: "Creator activity totals for a window"
method: POST
path: "/creators/summary"
tags: ["Creators"]
---

# Creator activity totals for a window

`POST /creators/summary`

Four headline totals for the shop over a date window: creators added, affiliate GMV earned, videos posted, and orders placed. Runs the same aggregate query that backs the summary cards above the portal's My Creators table, over the same trailing-28-day default window (TikTok reporting day, GMT-7).

`gmv_generated` and `video_posts` are scoped to the shop's CRM-tracked creators, which makes them narrower than their whole-shop namesakes on POST /metrics/summary (`gmv`, `videos_posted`) — the two will not agree, by design.

Aggregates cover the whole shop — there is no filter parameter in v1. Defaults to the trailing 28 days. Requires a single shop.

No prior-period comparison is included; for a period-over-period delta, call twice with adjacent windows and subtract. Returns 503 when the aggregate times out — back off and retry rather than treating it as a failure.

## Request body

- CreatorsSummaryRequest — POST /creators/summary request body.
  - `start_date` string, date, nullable — Window start (inclusive). Omit for a trailing 28-day window ending at end_date.
  - `end_date` string, date, nullable — Window end (inclusive). Defaults to today.

## Response `200`

Successful Response

- CreatorsSummaryResponse
  - `data` CreatorsSummaryTotals, required
    - `new_creators` integer, required — Creators whose first-ever CRM record falls inside the window.
    - `gmv_generated` number, required — Affiliate-attributed GMV earned in the window.
    - `video_posts` integer, required — Distinct videos posted in the window.
    - `orders` integer, required — Affiliate orders placed in the window.
  - `currency` string, required
  - `date_range` ResolvedDateRange, required — The window the server actually used, after defaults were applied.
    - `start_date` string, required
    - `end_date` string, required

## 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/30786bf76d4b/schema)