---
title: "Catalog"
method: GET
path: "/api/v1/remy/commerce/catalog"
tags: ["remy-commerce"]
---

# Catalog

`GET /api/v1/remy/commerce/catalog`

## Query parameters

- `search` string, nullable — Search public creator name, summary, niches, languages or location.
- `tier` 'ugc' | 'gold' | 'mega', nullable
- `page` integer
- `size` integer

## Response `200`

Successful Response

- PageCatalogCreatorDTO
  - `items` CatalogCreatorDTO[], required
    - `id` string, uuid, required
    - `catalog_creator_id` string, uuid, required
    - `tier` 'ugc' | 'gold' | 'mega', nullable, required
    - `display_name` string, required
    - `bio` string, nullable
    - `profile_summary` string, nullable
    - `age_range` string, nullable
    - `gender` string, nullable
    - `city` string, nullable
    - `region` string, nullable
    - `country` string, nullable
    - `country_code` string, nullable
    - `content_persona` ContentPersonaDTO
      - `content_styles` string[]
      - `presentation_styles` string[]
      - `strengths` string[]
    - `photo_url` string, nullable, required
    - `portfolio` CatalogMediaDTO[], required
      - `url` string, required
      - `kind` 'image' | 'video', required
      - `embed_url` string, nullable — Use an iframe for this player URL; otherwise render url as native media.
    - `languages` string[], required
    - `niches` string[], required
    - `followers` integer, nullable, required
    - `engagement_rate` number, nullable — Percentage points: 5.86 means 5.86%, not 0.0586.
    - `average_views` integer, nullable
    - `unit_amount` integer, nullable, required
    - `currency` 'usd', required
    - `can_order` boolean, required
  - `total` integer, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422` — Validation Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-21** `a6cea1834b97` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/commerce/catalog/get.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/ef659ddab5b1?raw)