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

# Catalog

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

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/commerce/catalog`
- Auth: HTTP bearer

## Query parameters

- `search` string, nullable: Search public creator name, summary, niches, languages or location.
- `tier` 'ugc' | 'gold' | 'mega', nullable
- `include_in_review` boolean
- `country` string, nullable
- `language` string, nullable
- `content_format` string, nullable
- `capability` 'editing' | 'script_writing', 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.
      - `media_id` string, uuid, nullable
      - `purpose` 'intro_video' | 'portfolio' | 'test_submission'
      - `poster_url` string, nullable
      - `is_cover` boolean
    - `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
    - `language_details` CatalogLanguageDTO[]
      - `language` string, required
      - `proficiency` 'native' | 'fluent' | 'professional' | 'conversational' | 'basic', nullable
    - `capabilities` string[]
    - `lifestyle` string[]
    - `appearance` string[]
    - `location_label` string, nullable
  - `total` integer, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

> 37 revisions in range; 1 not diffed.

- **2026-10-06** `866f7bfe8423`: 14 info
  - added the new optional `query` request parameter `capability`
  - added the new optional `query` request parameter `content_format`
  - added the new optional `query` request parameter `country`
  - added the new optional `query` request parameter `include_in_review`
  - …10 more
- **2026-09-21** `a6cea1834b97`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)