API: Search Similarity

All API calls require the key parameter. That is not shown in the below examples.

Overview

We're really excited about launching our Similarity APIs. We've had a few requests from developers on how they can show related products. These API's can help!

These API's are very much in beta. We actually use a different mechanism on our website to generate the recommendations you see there. But we're excited about offering these APIs early and we'll be using them on parts of our site soon. We'd love to hear your feedback on how good you feel the data is from these calls as we will constantly be enhancing our algorithms behind them.

The search similarity APIs supports: * visualSearch - Returns styles that look like the given style. * moreLikeThis - Returns styles that are similar to the passed in style based on the various attributes of the product itself. moreLikeThis uses more than just the look of the style (such as the description and meta data of the product).

visualSearch

/Search/Similarity?type=visualSearch&limit=<n>&styleId=<STYLE_ID>[&emphasis=<OPTIONS>]

Returns products that look like the passed in style.

Parameters:

  • limit - This is currently required but we'll be making it optional soon. We can return up to a maximum of 100 similar items at a time.
  • styleId - The style id you want similar items for
  • emphasis - You can use our algorithms to focus on "color", "shape" or "texture"

e.g. http://api.zappos.com/Search/Similarity?type=visualSearch&limit=5&styleId=287335&emphasis=color

moreLikeThis

/Search/Similarity?type=moreLikeThis&limit=<n>&styleId=<STYLE_ID>[&emphasis=<OPTIONS>]

Returns products that are similar to this style based on various attributes such as the description, meta data, etc.

Parameters:

  • limit - This is currently required but we'll be making it optional soon. We can return up to a maximum of 100 similar items at a time. NOTE - sometimes you may get less than your requested limit. This may be because we found a smaller number of similar items than you requested.
  • styleId - The style id you want similar items for
  • emphasis - You can use our algorithms to focus on "color", "style"

e.g. http://api.zappos.com/Search/Similarity?type=moreLikeThis&limit=5&styleId=287335&emphasis=style

Example Response

We tried to make the response mirror the response from our regular Search API as much as possible. We're currently working on tweaking this a bit to match it even closer.

 {
   "statusCode": "200",
   "results": [
    {
        "productId": "7193610",
        "productName": "Classic Nylon W",
        "productUrl": "http://www.zappos.com/product/7193610/color/4628",
        "thumbnailImageUrl": "http://www.zappos.com/images/719/7193610/8521-27300-t.jpg",
        "isHighRes": "false",
        "isNew": "false",
        "styleId": "27300",
        "originalPrice": "$49.50",
        "price": "$44.55",
        "productRating": "5",
        "onSale": "true",
        "brandName": "Reebok Lifestyle",
        "percentOff": "10%"
    },     
   [...]
    {
        "productId": "7226399",
        "productName": "SK8-Hi™ Core Classics",
        "productUrl": "http://www.zappos.com/product/7226399/color/500",
        "thumbnailImageUrl": "http://www.zappos.com/images/722/7226748/827-236963-t.jpg",
        "isHighRes": "false",
        "isNew": "false",
        "styleId": "236963",
        "originalPrice": "$55.00",
        "price": "$55.00",
        "productRating": "5",
        "onSale": "false",
        "brandName": "Vans",
        "percentOff": "0%"
    }
 ]
}
Drupal theme by Kiwi Themes.