List a brand's products (locator catalog)

Returns the brand’s products for populating the embeddable widget’s product-filter dropdown. Public, unauthenticated. Capped at the first 250 products by display name — brands with longer catalogs need the search variant (follow-up).

GET /brands/api/v1/public/brands/{brand_id}/catalog

List a brand's products (locator catalog)

cURL

curl --request GET \
  --url https://www.closient.com/brands/api/v1/public/brands/{brand_id}/catalog

200

{
  "brand": {
    "id": "<string>",
    "name": "<string>",
    "website": "",
    "logo_url": "<string>"
  },
  "products": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ]
}

Path Parameters

brand_id · string<shortuuid> · required

Brand short id (22-char shortuuid).

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Response

200 - application/json

OK

Top-level payload for the brand catalog endpoint.

brand · BrandSummaryOut · object · required

Identity of the brand whose catalog is being returned.

Show child attributes

Example:

{
  "id": "2sP1Y9pZ4xQ6rNvHwT3kBe",
  "logo_url": "https://cdn.closient.com/brands/acme/logo.png",
  "name": "Acme Beverages",
  "website": "https://acme.example.com"
}

products · ProductSummaryOut · object[] · required

Products owned by the brand, ordered by display name. Empty list when the brand has no products.

Show child attributes