---
title: "Daily series per creator"
method: POST
path: "/creators/trends"
tags: ["Creators"]
---

# Daily series per creator

`POST /creators/trends`

Daily time series for up to 100 named creators — affiliate GMV, video GMV, videos posted, video views, units sold, and commission. Backs sparklines and per-creator trend comparisons.

Every series is aligned positionally with the `days` axis and zero-filled, so index `i` of any array corresponds to `days[i]`. Creators with no activity in the window appear with all-zero arrays rather than being omitted; handles that don't exist in this shop are listed in `unresolved_handles` instead.

Defaults to the trailing 28 days. Requires a single shop.

## Request body

- CreatorTrendsRequest — POST /creators/trends request body.
  - `creator_handles` string[], required — Creator handles to fetch series for. Max 100 per call — this mirrors the internal per-page cap and keeps the response bounded. Handles that don't resolve in this shop are reported in `unresolved_handles`.
  - `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

- CreatorTrendsResponse
  - `data` object, required — Keyed by creator handle. Creators with no activity are zero-filled, not omitted.
  - `days` string[], required — ISO date axis for every series in `data`.
  - `unresolved_handles` string[] — Requested handles with no creator record in this shop. Absent from `data`.
  - `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/5eefff009b5b/schema)