Skip to main content
The More Like This endpoint finds products similar to a known source product. It is product-anchored: pass a product URL or indexed UUID, and Octogen derives the query from product enrichment, style, tags, audience, and optional facet constraints. Use POST /v1/products/more-like-this when you already have a product and want related items. Use POST /v1/products/search when the user starts from a keyword, facets, or an arbitrary price range.

​
Basic similar-products request

curl -sS https://api.octogen.ai/v1/products/more-like-this \
  -H "Authorization: Bearer $OCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "url": "https://warrenlotas.com/products/black-hoodie"
    },
    "limit": 12
  }'

​
Scope to one catalog

Omit catalog to search across all granted catalogs. Pass catalog when a related-products rail should stay within the same merchant: 
{
  "source": {
    "url": "https://warrenlotas.com/products/black-hoodie"
  },
  "catalog": "warrenlotas",
  "limit": 12
}

​
Choose relative price behavior

price_preference is relative to the source product’s currentPrice:
ValueBehavior
anyNo relative price filter. This is the default.
lowerPrefer less expensive alternatives.
higherPrefer premium alternatives.
page = await client.more_like_this_products(
    source_url="https://warrenlotas.com/products/black-hoodie",
    price_preference="higher",
    limit=8,
)

​
Add include or exclude facets

Use include_facets to pin extra requirements and exclude_facets to remove unwanted matches. These filters use the same facet shape as catalog search. 
curl -sS https://api.octogen.ai/v1/products/more-like-this \
  -H "Authorization: Bearer $OCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "url": "https://warrenlotas.com/products/black-hoodie"
    },
    "include_facets": [
      {"name": "gender", "values": ["unisex"]}
    ],
    "exclude_facets": [
      {"name": "color_family", "values": ["White"]}
    ],
    "limit": 12
  }'

​
Debug the derived query

Set debug: true to inspect the public, server-derived query fields used for retrieval: 
{
  "source": {
    "uuid": "prod_01HX..."
  },
  "debug": true,
  "limit": 6
}
The response adds effectiveQuery with fields such as text, retrievalEmbeddingColumns, facets, priceMin, priceMax, and limit. Use this for diagnostics and logging, not as a stable replacement for the endpoint itself.

​
Paginate similar products

More Like This uses the same cursor model as search. When a response contains nextCursor, pass it back as cursor with the same source and filters: 
let cursor: string | undefined;

do {
  const page = await client.moreLikeThisProducts({
    source: { url: "https://warrenlotas.com/products/black-hoodie" },
    cursor,
    limit: 12,
  });
  cursor = page.nextCursor ?? undefined;
} while (cursor != null);