UpStart Commerce Search
Recommendations
Visual Recommendation
3min
the visual recommendation endpoint enhances product discovery by providing visually similar product suggestions this service is particularly beneficial for fashion, home decor, and design centric platforms where appearance and style play a significant role in consumer choices accessing visual recommendations to retrieve visually similar product recommendations, businesses can use the visual recommendation api this api enables users to fetch alternatives based purely on image similarity how to retrieve recommendations make a get request send a request to the api endpoint with the product id provide required headers x upstart tenant identifies the retailer making the request x upstart site specifies the site where recommendations are needed receive a response the system returns a list of visually similar products api endpoint catalog endpoint → recommendation endpoint /catalog/live/recommendation/item/{product id}?recommendationtype=visually similar headers { "x upstart tenant" "yourtenant", "x upstart site" "your site id" "authorization" "bearer your auth token" } sample request curl location 'https //api yourdomain com/catalog/live/recommendation/item/{product id}?recommendationtype=visually similar' \\ \ header 'accept application/json' \\ \ header 'x upstart tenant yourtenant' \\ \ header 'x upstart site your site id' \[ { "id" "123456", "name" "example reclining loveseat", "brand" "furnitureco", "manufacturer" "bestmakers", "color" "gray", "dimensions" { "length" 75, "width" 40, "height" 42, "unit" "in" }, "features" \["reclining", "usb port"] }, { "id" "789101", "name" "premium loveseat", "brand" "homecomfort", "manufacturer" "topfurniture", "color" "beige", "dimensions" { "length" 80, "width" 38, "height" 40, "unit" "in" }, "features" \["power recline", "cup holder"] } ]