Updates to the Zappos API

Submitted by Anonymous on Wed, 04/03/2013 - 16:12

Howdy from Zappos!

As many of you may have noticed, the developer portal has been broken for a while now. This was partially due to an effort to keep the number of external API keys to a minimum, and to ensure that only those developers who truly wanted/needed a key got one. Today, I need to announce another change as well.

We're working on some exciting new changes to the API that will eventually result in a significant new major version. This new major version will not be backwards compatible with the existing version. We will be sure to provide notification through our many channels of communication (twitter, Google group, etc) as to when we plan to break backwards compatibility as well as provide guidance on how to transition your apps to the new API.

For now, the only change is that we will no longer be issuing API keys to external developers, as we begin to move away from our current stack. As stated earlier, those of you who currently possess a Zappos API key will continue to enjoy access to the API, as well as access to the developer docs.

This is just the first of many steps as we transition our development efforts in order to better serve our customers by delivering WOW through service. Please feel free to contact us at api@zappos.com with any questions.

Thanks!

Jim
Zappos API Team

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

Zappos API December Hack-a-long Contest Results

Submitted by Jimmy Jacobson on Wed, 03/28/2012 - 09:50

Friends, you were warned. Winter and Hackathon came and went, and while Winter was surprisingly mild, Hackathon was a blast. This was the first Zappos Hackathon to include a public contest for our friends at home to Hack-a-long with us.

We should have announced the winners a few months ago, but something happened that has delayed the judging. Without further ado, here are the winners of the Zappos API Hackathon Hack-a-long. Each winner will be getting $100 gift certificate from Zappos.

Best Overall

ZiftBot

Mobile webapp for helping you pick out the wrong gift for the right person. Uses the Zappos API and SendGrid API for email.

Fun and Most Weird

Gifting Core Values

Send a personalized email to someone close to you with your favorite Zappos Core Value in it using the SendGrid API and Zappos API.

Best Mashup

Anonysize

Ever been shopping for someone but didn't know their shoe size? Sure you can sneak around and ask friends or family for help. Or you can use Anonysize to anonymously ask that person for their shoe size via SMS. Using the Zappos API and Twilio

Gifting - Zappos API Hackathon Hack-a-long Contest

Submitted by Jimmy Jacobson on Mon, 12/12/2011 - 00:06

Hackathon is here. For this entire week, Zappos developers will be engaged in glorious Hackathon. And we want to invite you to Hack-a-along with us from home in the form of an API contest. This contest was announced a few weeks ago and was only missing one thing. A theme. But today, that theme has arrived.

Gifting.

Gifting is a combination of the words Giving - the act of To Give and Lefting - German for the opposite of Righting. Wait, our lawyers just informed me that is not correct. Okay, let's just say that scientists may never agree on the actually definition of Gifting. Gifting is our theme for this Hack-a-long contest.

We are looking for anything that leverages the Zappos API and falls into the theme of Gifting. We aren't even saying the final product has to be electronic...

For more information on eligibility and how to enter see here.

Here are the "Official" prizes:
The prizes:

  • Best Overall Application: $100 value ($100.00 Zappos.com electronic gift certificate)
  • Most Fun and Weird Application: $100 value ($100.00 Zappos.com electronic gift certificate
  • Best Mash-up Application (integrating other APIs or apps): $100 value ($100.00 Zappos.com electronic gift certificate

Astute readers may have noticed the "air quotes" around "Official". Does this mean there are also "Unofficial" prizes? YES! Some of our friends have decided to pitch in prizes as well for the best uses of both the Zappos API and their own!

  • Rovi: APIs for Multi-Media
  • TokBox: Drop in some video chat with Open-Tok
  • SendGrid: Get your email on!
  • Context IO: API for quick and easy indexing of email inboxes. Hint... you could pull all the Zappos order confirmation emails out of an inbox and do something cool with them.
  • Twilio - make almost anything SMS or Voice capable using Twilio APIs and tools. And I mean ANYTHING. Including the Kindle Fire they are offering as a prize!

Judging for this contest will be performed by Zappos Employees. All [#currentZapposEmployeeCount] of us! Everyone from the executive team (Hi Tony!) to our Customer Loyalty Team will get to play with your apps and vote on the winners along side voting for our internal Hackathon.

This contest ends Friday afternoon at 5pm PST so get cracking and have fun. Let us know (api@zappos.com) if you have any questions.

Support and help is available via both email, google group and via twitter (@zappos_api)

Syndicate content
Drupal theme by Kiwi Themes.