---
title: "Sample metrics by product"
method: POST
path: "/samples/by-product"
tags: ["Samples"]
---

# Sample metrics by product

`POST /samples/by-product`

Sample performance breakdown by product. Shows requests, approvals, and GMV per product. Data can be up to three days stale, given the delay in affiliate center.

## Request body

- SamplesByProductRequest — POST /samples/by-product request body.
  - `page` integer
  - `page_size` integer
  - `sort_by` 'total_requests' | 'approved' | 'sample_gmv', nullable
  - `sort_dir` 'asc' | 'desc'
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable

## Response `200`

Successful Response

- SamplesByProductPaginatedResponse
  - `data` SampleByProductItem[], required
    - `product_id` string, required
    - `product_name` string, nullable
    - `total_requests` integer, nullable
    - `approved` integer, nullable — DB: shipped_sample_cnt
    - `sample_gmv` number, nullable
    - `videos_from_samples` integer, nullable — DB: received_sample_and_posted_video_cnt
  - `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)