Skip to main content
Given a product_id, products.find_similar returns the closest neighbors. Add filters to narrow results by gender, brand, category, or price. 
import Channel3 from "@channel3/sdk";

const client = new Channel3();

const similar = await client.products.find_similar({
  product_id: "2yh8WH5",
  limit: 10,
  filters: {
    gender: "female",
    price: { max_price: 200 },
  },
});

console.log(similar.products.map((p) => p.title));

from channel3_sdk import Channel3

client = Channel3()

similar = client.products.find_similar(
    product_id="2yh8WH5",
    limit=10,
    filters={
        "gender": "female",
        "price": {"max_price": 200},
    },
)
print([p.title for p in similar.products])

curl -X POST https://api.trychannel3.com/v1/similar \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "2yh8WH5", "limit": 10, "filters": {"gender": "female", "price": {"max_price": 200}}}'

​
Creative uses of /similar

  • “Shop the look” — for a shirt result, filter the similar call to pants and shoes categories to suggest a full outfit.
  • Couple’s shopping — exclude the source product’s gender to surface his-and-hers alternatives.
  • Budget finder — set a price ceiling based on the source product’s price to surface similar but cheaper items.
  • Shop for the whole family — add an age filter (kids, toddler) to find children’s versions of an item.