API Documentation

REST API

All the cool kids are doing it. It's true! We decided to launch our API as REST only because that's the trend we have been seeing in the API world these days. But we want to know if hear from you if you really want XML or any other format as well.

API Documentation

Note, for all of the examples below, make sure to use your API key (key=YOUR_KEY_HERE)

API Description Example
Search Perform a real time search against our totally impressive product catalog. Not just shoes! Anyone need a kettle or some lipstick? http://api.zappos.com/Search?term=boots
Product Pull full product details. It's a bundle of information and joy. http://api.zappos.com/Product/7515478?include=["styles"]
Image Get a robust set of images for all of our products. Did you know we shoot our own images here at Zappos? It's always hunting season here. http://api.zappos.com/Image?productId= 7515478
Statistics Our fun api! Get cool stats about Zappos purchases. http://api.zappos.com/Statistics?type=latestStyles
Brand Did you know we carry almost 1000 brands? Get more details on specific brands with this API http://api.zappos.com/Brand/101
Review Zappos has thousands of reviews from our amazing customers. Find out what our customer's are saying about our products http://api.zappos.com/Review?productId=7480195
AutoComplete The AutoComplete API will let you implement search auto-complete on your own site. http://api.zappos.com/AutoComplete?term=nike
CoreValue New! Nothing screams Zappos like our Core Values http://api.zappos.com/CoreValue
Similarity New & BETA! Want to find out what products look or are similar to a given style? Now you can! http://api.zappos.com/Search/Similarity?type=visualSearch&limit=5&styleId=1177403

Supporting JSONP

Our API supports wrapping the response in a JSONP callback. You can include the callback parameter:

e.g. : /Product?id=["12345"]&callback=wrapper

wrapper(
 {
   "statusCode": "200",
   "product": 
    {
       "id":"12345",
       "brand":"Ugg",
       "name":"Classic Short",
       "description":"The 'Classic Short' runs large and is available in whole sizes."
    }
  }
 )

Change Log/Revision History

As of 11/10/2010, we are on version 1.7 of our API. As we release new versions, we'll update this portal with a change log. If we think there will be some backwards compatibility issues, we'll be blogging about it and emailing our google group with details ahead of time.

We also have it on our roadmap to support multiple versions in parallel. This will make life easier for you if we do introduce things that might break backwards compatibility.

A lot of our work recently has been on API's that support the full checkout experience. As we mention in the FAQ, those aren't made public yet and we don't detail them below. Sorry!

9/27/2010 - Release 1.5

10/15/2010 - Release 1.6

  • Lots of bug fixes
  • We performance tuned the Stats API and in the process made it slower and return too much data! Zoinks.
  • Various infrastructure-behind-the-curtain-goodness
  • Our Core Value API!

11/3/2010 - Release 1.7

  • More bug fixes
  • Fixed up our Stats API. It should be much speedier!
  • More infrastructure stuff
  • Launched in BETA the Similarity API

11/23/2010 - Release 1.8

  • Misc bug fixes
  • Lots of reworking in our internal API management tools
  • Support for returning multiple video formats in the product API
  • Improved performance in Statistics API

12/1/2010 - Release 1.9

  • Internal usage bug fixes

2/25/2011 - Release 2.0

3/2011 - Release 2.0.1

  • Bug fixes

4/2011 - Release 2.1

  • Bug fixes
  • Internal only features: outfit builder and Returns support

5/2011 - Release 2.1.1

6/2011 - Release 2.2

7/2011 - Release 2.2.1

  • Improved API error documentation
  • Fixed facet sorting
  • Fixed <a href="/docs/api-search-api>search API bugs using single quoted array inputs

8/2011 - Release 2.3

  • Beta version of Commission Junction (CJ) affiliate support. Please contact api@zappos.com if you would like to be part of the program.
  • Fixed zip code filtering in stats API
  • Returning UPCs in the Product API at the stock level
  • Support returning only facets in Search API that are filterable

9/2011 - Release 2.4

  • Various internal only fixes (believe us, we were yelled at a lot less by our teammates after this release)

9/2011 - Release 2.5 (2.5.1 and 2.5.2)

  • A few more internal only enhancements and infrastructure improvements

10/2011 - Release 2.6

  • Exposing standard/alternate dimensions for sizing
  • Updated the Product API to return our new gender values as well as a new set of meta data per product (attributeFacetFields).
  • Improved Search results! API results more closely match some magic rules used on the website. e.g. When the word "sale" is in the search term, only return sale items (duh), understand synonyms (a search for "uggs" or "ugg" is the same), and better handling searches that include a gender in the search query
Drupal theme by Kiwi Themes.