Reviews

Description
Request URL
Path and Query Parameters
Sample Requests and Responses
Error Codes

GetReviews

Description

This service retrieves information about Bloomingdales.com customer reviews.

HTTP Method and Request URL

GET

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

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. Go to http://developer.bloomingdales.com/apps/mykeys 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	70323
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	magicofbloomingdalesapi

Sample Requests and Responses

Sample Request

Request URL:

GET

http://api.bloomingdales.com/v3/catalog/reviews?productId=70323&numberOfReviewsRequested=2

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

Sample Response

{
    "productId": 622085,
    "productName": "Montblanc 4810 Westside SLG 8 Card Wallet",
    "description": "Carry your essentials in a handsome full-grain calfskin wallet from Montblanc for an authentic and refined addition to your every day.",
    "source": "Bloomingdales",
    "averageOverallRating": 5.0,
    "overallRatingRange": 5,
    "countFor5Stars": 4,
    "totalReviewCount": 4,
    "recommendedCount": 4,
    "rateOnlyReviewCount": 0,
    "perReviewWrapper": [{
        "reviewId": 54420691,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2014-02-23T19:45:07-05:00",
        "reviewerId": "2015533627",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": true,
        "reviewTitle": "Awesome classy wallet",
        "reviewDesc": "It's a nice black wallet that holds a good number of cards yet remains stylish (not bulky) after it's filled up. It seems to be very strong. I think it will last a long time.",
        "reviewDate": "2014-02-20T20:44:21-05:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.bloomingdales.com/7130aa/622085/montblanc-montblanc-4810-westside-slg-8-card-wallet-reviews/reviews.htm?reviewID=54420691",
        "featured": false,
        "genderValue": "Female",
        "displayName": "elliel",
        "ipAddress": "98.239.129.62",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 42799766,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2013-06-03T00:00:06-04:00",
        "reviewerId": "1161323101",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": true,
        "reviewLocation": "Orange County, CA",
        "reviewTitle": "Montblanc is the Best",
        "reviewDesc": "After working around leather accessories for a few years, you come realize which products stand out as the best.\n\nMontblanc is the best, when it comes to leather goods. The amount of care that is put into each piece, coupled by the fantastic warranty proves that the product is perfect.\n\nThe saffiano leather on this piece is an excellent addition, because of its scratch resistant nature. Wallets tend to wear quickly, but this slows down the already slow process of a Montblanc Leather good.",
        "reviewDate": "2013-06-02T06:01:20-04:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.bloomingdales.com/7130aa/622085/montblanc-montblanc-4810-westside-slg-8-card-wallet-reviews/reviews.htm?reviewID=42799766",
        "featured": false,
        "genderValue": "Male",
        "styleValue": "Fearless Fashionista (F)",
        "displayName": "MontblancSpecialist",
        "ipAddress": "76.171.53.103",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 36411030,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2012-11-07T05:15:38-05:00",
        "reviewerId": "914214233",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": true,
        "reviewLocation": "RI",
        "reviewTitle": "Very nice, strongly recommend",
        "reviewDesc": "i bought this wallet for my husband. After i received it, i was so glad that i bought this product. It is so nice. I like the texture of the leather, which makes it elegant. My husband likes it too. I will definitely recommend to my friends.",
        "reviewDate": "2012-11-06T12:02:36-05:00",
        "totalFeedbacksOnReview": 0,
        "positiveFeedbacksOnReview": 0,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.bloomingdales.com/7130aa/622085/montblanc-montblanc-4810-westside-slg-8-card-wallet-reviews/reviews.htm?reviewID=36411030",
        "featured": false,
        "ageRangeValue": "25-34",
        "genderValue": "Female",
        "styleValue": "Comfort Connoisseur (F)",
        "displayName": "snowy",
        "ipAddress": "138.16.126.227",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }, {
        "reviewId": 33952840,
        "reviewStatus": "APPROVED",
        "lastModificationDate": "2012-10-20T21:41:27-04:00",
        "reviewerId": "1416756711",
        "anonymous": false,
        "ratingsOnly": false,
        "ratingValue": 5,
        "ratingRange": 5,
        "recommended": true,
        "reviewLocation": "New York, NY",
        "reviewTitle": "My boyfriend loves this",
        "reviewDesc": "Simple but very stylish. I liked it online and went to the actual store to buy it - it feels as nice it looks in picture.",
        "reviewDate": "2012-08-12T09:28:41-04:00",
        "totalFeedbacksOnReview": 2,
        "positiveFeedbacksOnReview": 2,
        "negativeFeedbacksOnReview": 0,
        "productReviewURL": "http://reviews.bloomingdales.com/7130aa/622085/montblanc-montblanc-4810-westside-slg-8-card-wallet-reviews/reviews.htm?reviewID=33952840",
        "featured": false,
        "ageRangeValue": "25-34",
        "genderValue": "Female",
        "styleValue": "Fearless Fashionista (F)",
        "displayName": "luisina",
        "ipAddress": "159.53.110.140",
        "displayLocale": "en_US",
        "moderationStatus": "APPROVED",
        "topContributor": false
    }]
}

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

version 14 as of 11 years ago by Damian Bennett