UpStart Commerce Search
Recommendations
Alternate Product Recommendation
4min
the alternate product recommendation endpoint enhances the product discovery experience for consumers while increasing catalog exposure for retailers this feature is integrated into the upstart commerce search application, enabling personalized recommendations based on product attributes rather than visual similarity accessing product recommendations to retrieve alternate product recommendations for a specific product, businesses can use the alternate recommendation api this api allows users to fetch relevant alternatives based on predefined attributes 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 particular site where recommendations are needed receive a response the system will return a list of recommended products with relevance scores api endpoint catalog endpoint → recommendation endpoint /catalog/live/recommendation/item/{product id}?recommendationtype=similar headers { "x upstart tenant" "tenant", "x upstart site" "site" "authorization" "bearer your auth token" } example request a retailer wants recommendations for a particular product curl location 'https //api yourdomain com/catalog/live/recommendation/item/{product id}?recommendationtype=similar' \\ \ header 'accept application/json' \\ \ header 'x upstart tenant tenant' \\ \ header 'x upstart site site' \[ { "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" ] } ]