---
title: "Video performance (date-filtered)"
method: POST
path: "/videos/performance"
tags: ["Videos"]
---

# Video performance (date-filtered)

`POST /videos/performance`

Top videos ranked by GMV or views earned within a specific date range. Unlike /videos/list (which shows lifetime totals), this endpoint uses daily performance data and matches the dashboard's 'Top Videos' section exactly. Defaults to the last 30 days. Use this for period-specific rankings, trend analysis, and correlating video performance with product sales.

## Request body

- VideoPerformanceRequest — POST /videos/performance request body.
  - `page` integer
  - `page_size` integer
  - `sort_by` 'video_gmv' | 'views' | 'like_count' | 'order_count' | 'posted_date', nullable
  - `sort_dir` 'asc' | 'desc'
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `creator_handle` string, nullable
  - `min_gmv` number, nullable
  - `min_views` integer, nullable

## Response `200`

Successful Response

- VideoPerformanceResponse
  - `data` VideoPerformanceItem[], required
    - `video_id` string, required
    - `title` string, nullable
    - `creator_handle` string, nullable
    - `tiktok_url` string, nullable — Canonical TikTok video permalink (the watch page): https://www.tiktok.com/@<handle>/video/<id>. Null when the handle is unavailable.
    - `video_gmv` number, nullable — GMV earned in the date range (not lifetime)
    - `views` integer, nullable — Views in the date range (not lifetime)
    - `like_count` integer, nullable
    - `comment_count` integer, nullable
    - `order_count` integer, nullable
    - `posted_date` string, nullable
  - `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)