---
title: "Creator performance (date-filtered)"
method: POST
path: "/creators/performance"
tags: ["Creators"]
---

# Creator performance (date-filtered)

`POST /creators/performance`

Top creators ranked by GMV earned within a specific date range. Unlike /creators/list (which shows lifetime GMV), this endpoint uses daily performance data and matches the dashboard's 'Top Creators' section exactly. Defaults to the last 30 days. Use this for period-specific rankings and reports.

## Request body

- CreatorPerformanceRequest — POST /creators/performance request body.
  - `page` integer
  - `page_size` integer
  - `sort_by` 'gmv' | 'units_sold' | 'order_count' | 'est_commission' | 'follower_count', nullable
  - `sort_dir` 'asc' | 'desc'
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `creator_handle` string, nullable
  - `min_gmv` number, nullable

## Response `200`

Successful Response

- CreatorPerformanceResponse
  - `data` CreatorPerformanceItem[], required
    - `creator_id` string, required
    - `creator_handle` string, nullable
    - `gmv` number, nullable — GMV earned in the date range (not lifetime)
    - `units_sold` integer, nullable
    - `order_count` integer, nullable
    - `est_commission` number, nullable
    - `follower_count` integer, nullable — Latest follower count in the period
  - `currency` string, required
  - `pagination` unknown, required
  - `date_range` DateRange
    - `start_date` string, nullable
    - `end_date` string, nullable
  - `shops_queried` string[], nullable — Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

## 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)