• Register

Reviews V3

Description

This service retrieves information about macys.com customer reviews.

back to top

HTTP Method and Request URL

GET

https://api.macys.com/v3/catalog/reviews?productId=[productId]&numberOfReviewsRequested=[numberOfReviewsRequested]

back to top

Path and Query Parameters

HTTP Header Parameters
Parameter Description Mandatory Sample Value
Accept Specifies the output format. Can be application/json or application/xml.    
Yes

application/json

application/xml
apikey Pass the apikey as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. Click here for a list of your API keys.
Yes xmj9js4jkdpe1983fmwu98gh

Query Parameters

Parameter Description Mandatory Sample Value
productId  Product id from the website (web ID) Yes  199462
numOfReviews  Must be number. Defaults to 10 if not sent in this parameter.
 No  1
pageNumber You can specify which page you return.  For instance if there are 20 reviews and you are returning 10 reviews per page then you could specify page 2 to get the second page of reviews. Default is 1 No 2
callback If sent, the format is JSONP (JSON with Padding) with the callback returned with the JSON response. You can put anything in the callback parameter and whatever you send is returned.  No magicofmacysapi

back to top

Sample Requests and Responses

Sample Request

Request URL:

GET

http://api.macys.com/v3/catalog/reviews?productId=199462&numberOfReviewsRequested=5

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

Sample Response

{
    "productId": 199462,
    "productName": "KitchenAid KSB560 Blender, 5 Speed",
    "description": "With smooth color selections, unique contours and unsurpassed power, this polycarbonate jar blender is the clear choice for all your needs. Built for continual blending, the patented razor-sharp stainless steel blades whirl until the job is done. 1-year hassle-free replacement warranty. Model KSB560.",
    "source": "Macys",
    "averageOverallRating": 4.3196,
    "overallRatingRange": 5,
    "countFor1Star": 16,
    "countFor2Stars": 2,
    "countFor4Stars": 11,
    "countFor5Stars": 76,
    "totalReviewCount": 97,
    "recommendedCount": 77,
    "rateOnlyReviewCount": 1,
    "perReviewWrapper": [{
        "reviewId": 51711619,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-04-30T22:00:08-04:00",
        "reviewerId": "5954903382",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "wonderful gift",
        "reviewDesc": "So far I've used my blender for smoothies and it's great. Very powerful. Sleek look. The top part is plastic, but it doesn't look or seem cheap. Very easy to clean, water plus soap & then blend!",
        "reviewDate": "2013-04-29T20:31:22-04:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=51711619",
        "featured": false,
        "displayName": "Soon2BeMrsD",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 51693744,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-04-30T15:15:13-04:00",
        "reviewerId": "895070907",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "love my new blender",
        "reviewDesc": "makes great milk shakes, fruit smoothies and crushes ice for drinks",
        "reviewDate": "2013-04-29T14:50:22-04:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=51693744",
        "featured": false,
        "displayName": "Gramae",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 50970345,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-04-23T14:56:03-04:00",
        "reviewerId": "4053877742",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 1,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "unhappy",
        "reviewDesc": "This blender leaks at the bottom. Not happy. I keep using it because I am past the return time, but would like to look at something else. Vitamix is sooooo expensive for me.",
        "reviewDate": "2013-04-08T18:24:10-04:00",
        "totalFeedbacksOnReview": 1,
        "positiveFeedbacksOnReview": 1,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=50970345",
        "featured": false,
        "displayName": "lovesmoothies",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 49801850,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-04-23T14:57:03-04:00",
        "reviewerId": "514336717",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 1,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "Plastic container",
        "reviewDesc": "I purchased this blender a year ago. When I was in the store I had asked the sales person about the plastic blender top and if there had been any issues with it. She told me no. I had to tighten the nut on the bottom a few times to stop the leaking. Now the nut is loose and cannot be tightened as it has a gap like it is missing a washer or something. I will never buy a blender again that has a plastic top. I have had glass ones that never had this problem they just wore out the motor.",
        "reviewDate": "2013-03-15T13:34:56-04:00",
        "totalFeedbacksOnReview": 1,
        "positiveFeedbacksOnReview": 1,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=49801850",
        "featured": false,
        "displayName": "88harley",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 47027670,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-02-19T14:30:13-05:00",
        "reviewerId": "4599130094",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": false,
        "reviewLocation": "Portland, OR",
        "reviewTitle": "Great blender!",
        "reviewDesc": "Works great! Crushes ice, makes smoothies, purees soups, and looks pretty on the counter.",
        "reviewDate": "2013-02-18T13:10:18-05:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=47027670",
        "featured": false,
        "ageRangeValue": "25-29",
        "genderValue": "Female",
        "shoppingFrequencyValue": "Frequently",
        "displayName": "kitchenmaid1",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 46400519,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-05-24T07:12:38-04:00",
        "reviewerId": "4220056714",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "i just love Red!",
        "reviewDesc": "am happy bacause after purchasing the Red Kitchenaide blender and the Red cooking set i just love more my kitchen because everything that my eyes see now are all Red. I wish Kitchenaide will also ccome up in selling very soon Red Kitchenaide Rice Cooker...",
        "reviewDate": "2013-02-12T09:16:14-05:00",
        "totalFeedbacksOnReview": 2,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 2,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=46400519",
        "featured": false,
        "displayName": "Jenipot",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 46165139,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-06-01T07:50:04-04:00",
        "reviewerId": "374150438",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": true,
        "reviewLocation": "Bainbridge Island, WA",
        "reviewTitle": "KitchenAid Blender",
        "reviewDesc": "Very happy with this new blender. It is the quietest blender I have ever had, due largely to the heavy duty motor base which hums with a deep roar instead of a loud screech like so many blenders. Also the plastic container does not seem to translate the noise like glass containers do. A good choice!",
        "reviewDate": "2013-02-03T13:06:14-05:00",
        "totalFeedbacksOnReview": 1,
        "positiveFeedbacksOnReview": 1,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=46165139",
        "featured": false,
        "ageRangeValue": "Over 60",
        "genderValue": "Male",
        "shoppingFrequencyValue": "Occasionally",
        "displayName": "CTM1",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 40539879,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-03-30T23:52:26-04:00",
        "reviewerId": "516146247",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 4,
        "ratingRange": 5,
        "recommended": false,
        "reviewLocation": "Snellville, GA",
        "reviewTitle": "Good Blender For Price",
        "reviewDesc": "I purchased this blender at a Macy's Store in Black. It chops up frozen fruit well for smoothies as long as you use enough liquid. I have even made homemade rice cereal powder with this blender by using regular brown rice. After a few minutes of blending the hard rice was a fine powder. This is a good blender for the price.",
        "reviewDate": "2012-11-30T12:46:23-05:00",
        "totalFeedbacksOnReview": 1,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 1,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=40539879",
        "featured": false,
        "ageRangeValue": "30-39",
        "genderValue": "Female",
        "shoppingFrequencyValue": "Frequently",
        "displayName": "Deeva76",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 38600579,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-03-25T10:26:03-04:00",
        "reviewerId": "686319973",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 1,
        "ratingRange": 5,
        "recommended": false,
        "reviewLocation": "Bay Area, CA",
        "reviewTitle": "don't get this",
        "reviewDesc": "I thought the design of this blender was great and I too had it on my wedding registry. Unfortunately, after one month of making smoothies daily, this product started to fail and leaks often. Frozen fruit doesn't mix well at all so we only use fresh fruit with it but the knob under the blender also causes the leaked juice to turn black and create a bigger mess to clean up. We managed to keep using it for one year but its time to upgrade to a new model.",
        "reviewDate": "2012-09-10T23:32:41-04:00",
        "totalFeedbacksOnReview": 4,
        "positiveFeedbacksOnReview": 4,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=38600579",
        "featured": false,
        "ageRangeValue": "25-29",
        "genderValue": "Female",
        "shoppingFrequencyValue": "Occasionally",
        "displayName": "macysdiva",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 38395346,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-03-25T10:27:56-04:00",
        "reviewerId": "6405622389",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 1,
        "ratingRange": 5,
        "recommended": false,
        "reviewTitle": "Worst blender ever had",
        "reviewDesc": "My family makes smoothies often for the whole family at once this blender wouldn't even blend the frozen strawberries that we put in for one person. We had to send it back twice to get fixed. It took forever to actually mix everything together. Overall it was the worst blender I have ever had. I would not recommend it. It was a huge pain. Also we would have to stick a spoon in to help mix it around it does not work well on its own. People who are rating this well probably have only tried soft things. This is not a worthwhile purchase. It's beyond me why anyone could love this blender.",
        "reviewDate": "2012-09-03T13:33:27-04:00",
        "totalFeedbacksOnReview": 3,
        "positiveFeedbacksOnReview": 3,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.macys.com/7129aa/199462/kitchenaid-ksb560-blender-5-speed-reviews/reviews.htm?reviewID=38395346",
        "featured": false,
        "displayName": "Truthfully123",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }]
}

back to top

 

cURL Example

curl -X GET -H "x-macys-webservice-client-id: xxxxxxxxxx" -H "Accept: application/json" "http://api.macys.com/v3/catalog/reviews?productId=199462&numberOfReviewsRequested=5"

 

 

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

version 21 as of 9 years ago by Unknown

Docs Navigation