Reviews

GetReviews

Description

This service retrieves information about Bloomingdales.com customer reviews.

back to top

HTTP Method and Request URL

GET

https://api.bloomingdales.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. 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

back to top

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
    }]
}

back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation