API: Review

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

Overview

Zappos is extremely proud of our amazing customers. Check out what some of our customer's have to say on the Zappos.com Facebook Fan page: http://www.facebook.com/zappos.

Thanks to our customers, we have an incredibly robust set of reviews for many of our products. The Review API can be used to pull some of this great review data.

Terms of Use

  • We are happy for you to use our reviews, but please make sure to attribute the reviews back to Zappos.com
  • Our review data cannot be used to solely drive traffic to other sites. If your site has shopping options, Zappos needs to be one of those options
  • Refer to our full API license for complete details

Get Product Reviews

/Review?productId=<PRODUCT_ID>

e.g. /Review?productId=7452211

{
  "statusCode": "200",
  "page": 1,
  "offset": 0,
  "reviews": [
    {
        "id": "2255880",
        "date": "05/19/2010 07:26 AM",
        "name": "",
        "location": "Washington, DC",
        "otherShoes": "",
        "summary": "These slippers are very comfy! The only issue I have is that my foot slips off of the memory foam bottom sometimes (it is almost like an insert) and I stumble.",
        "shoeSize": "FULL_SIZE_SMALLER",
        "shoeWidth": "TRUE",
        "shoeArch": "NONE",
        "overallRating": "4",
        "comfortRating": "5",
        "lookRating": "5"
    },
    {
        "id": "2226683",
        "date": "04/19/2010 04:56 AM",
        "name": "Jennifer M",
        "location": "Fort Lauderdale, Florida",
        "otherShoes": "",
        "summary": "I bought these boots for my niece who was going on a college tour in South Carolina, Georgia and Florida during a cool weather spell and this pair was popular among teen age girls and really comfortable and warm. She loves them. Good choice. Thanks Zappos! ",
        "shoeSize": "TRUE_TO_SIZE",
        "shoeWidth": "TRUE",
        "shoeArch": "MODERATE",
        "overallRating": "5",
        "comfortRating": "5",
        "lookRating": "5"
    },
    {
        "id": "2203429",
        "date": "03/23/2010 11:35 AM",
        "name": "Arlene K",
        "location": "Warminster, PA",
        "otherShoes": "",
        "summary": "Ordered these because my other slippers gave up after the winter season. They are super comfortable and warm and fit me even though I have a wide foot.",
        "shoeSize": "TRUE_TO_SIZE",
        "shoeWidth": "WIDER",
        "shoeArch": "MODERATE",
        "overallRating": "5",
        "comfortRating": "5",
        "lookRating": "5"
    },
    ...
  ]
}

Pagination and Offsets

Many of our products have hundreds of reviews. There are a few ways to filter what reviews are shown:

  • page - indicate what page of the reviews should be shown. We currently show 25 per page
  • startId - Get reviews since a given review id
  • startDate - Get reviews since a given date. Date input needs to be a full timestamp

e.g.

  • /Review?productId=12345&page=2
  • /Review?productId=12345&startId=56789
  • /Review?productId=12345&startDate=09/28/2010%2006:05%20AM

We have it on our list of issues to support returning the total number of reviews per call so you can tell how many pages there are.

Drupal theme by Kiwi Themes.