Search 4.0
GetSearchPhrase
Description
This service allows the users to search for a keyword and return product results matching that particular keyword.
Distinct features of V4 Products API
Syntax: https://api.bloomingdales.com/v4/catalog/search?searchphrase=search keywords
Examples:
- Keyword of brand ‘red dress’
https://api.bloomingdales.com/v4/catalog/search?searchphrase=keyword search
HTTP Method and Request URL
GET
https://api.bloomingdales.com/v4/catalog/search?searchphrase=keyword search
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 |
|
x-macys-webservice-client-id |
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 |
|
searchphrase |
whatever is entered in the search area |
Yes |
red dress |
|
show |
shows products or facets only. If neither product or facet requested, shows BOTH products AND facets |
No |
product, facet |
| sortorderby | default is the original order returned by the database call | No |
PRICE_ASCENDING PRICE_DESCENDING CUSTOMER_RATING NEWNESS BEST_SELLERS |
| perpage | default 12. not more than 24 per page | No | 24 |
| page | What is current page number requested. default 1 | No | Optional 2 |
| facetexpandall | User wants to see ALL facet values listed for the search . Default will show only first 10 values for each facet | No | true |
| BRAND | Will filter data pertinent to requested refinements. All 4 samples shown in column 1 can be requested separately or together | No |
CK, COLOR=[PINK,YELLOW] PRICE=[‘*TO50]PRICE=[0TO50] PRICE=[50TO100] CATEGORY=[women, apparel, shoes] Note: facet values must be URL encoded. For instance: Sales & Discounts would need to be formated: Sales%20%26%20Discounts |
| imagewidth | imagewidth of images returned | No |
100 (Pixels) |
| upcimagewidth | imagewidth of upc images returned | No |
100 (Pixels) |
| swatchimagewidth | imagewidth of upc images returned | No |
100 (Pixels) |
| include | This parameter allows you to return additional information about products such as promotions and product description. NOTE: Can only be used if the show=product also. | No | promo,proddesc |
| avoidredirects | When a search input includes the name of a Bloomingdales category we return the category ID in the response as a redirect instead of the products and facets that would normally be delivered. (Ex. Search phrase: chanel) You can avoid this by seeing this parameter to true. Default is false. | No | true or false |
| invassort | Pass Inventory Assortment value to retreive Context specifc to return customized search results. Default is SITE |
No | STORE, SITE, JEWELRY, WEDDING_REGISTRY, SHOES, SEARCH_AND_SEND |
| appl | Pass Application value to retreive Context specifc to return customized search results. Default is ASSOCIATE |
No | SITE, ASSOCIATE, MOBILE, MEW,SEO_LINK_MODULE, SEARCH_AND_SEND |
| device | Pass Device value to retreive Context specifc to return customized search results. Default is TABLET | No | PHONE, TABLET, PC, POS |
| country | Pass Country value to retreive Context specifc to return customized search results. Default is US |
No | US |
| 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 |
The Parameters are posted in URL. Multiple parameteres with values can be used in the same API call. However, multiple values for the same attribute should be specified by repeating the attribute name separated by ‘&’.
Facet Rules (include sort, page and ppp params in the facetMoreLessUrl links)
- If facet has less than 10 values, do not populate output schema attributes of facetMoreLess or facetMoreLessUrl.
- If facet has more than 10 values, and there is NO input parameter facetexpand, then the output schema will have for EACH FACET the attribute of facetMoreLess = “More” and facetMoreLessUrl would be a relative URL such as v4/catalog/search?searchphrase=red dress&sortorderby=DEFAULT&ppp12&page=2&facetexpand=[name of THAT SPECIFIC FACET such as BRAND or COLOR or PRICE]
- If facet has more than 10 values and there IS an input parameter such as facetexpand=BRAND, then the output schema will have the attribute of facetMoreLess = “Less” for that facet value of BRAND and the facetMoreLessUrl would be a relative URL such as v4/catalog/search?searchphrase=red dress&sortorderby=DEFAULT&ppp12&page=2. There will not need to be a facetexpand parameter in the output schema for the BRAND facet value. However for ALL the other facets not mentioned in the input param like COLOR and PRICE, they will have a similar output as Number 2 above since no input param was set for those facet values. e.g. for facet of COLOR would be: the output schema will have the attribute of facetMoreLess = “More” and facetMoreLessUrl would be a relative URL such as v4/catalog/search?searchphrase=red dress&sortorderby=DEFAULT&ppp12&page=2&facetexpand=COLOR, e.g. the output schema values for facet of PRICE would be: the output schema will have the attribute of facetMoreLess = “More” and facetMoreLessUrl would be a relative URL such as v4/catalog/search?searchphrase=red dress&sortorderby=DEFAULT&ppp12&page=2&facetexpand=PRICE.
Sample Requests and Responses
Sample Request
Request URL:
GET
http://api.bloomingdales.com/v4/catalog/search?searchphrase=red dress&sortorderby=PRICE_ASCENDING&perpage=10&page=2&imagewidth=100&upcimagewidth=100&swatchimagewidth=100
HTTP Header:
X-Macys-Webservice-Client-Id: xmj9js4jkdpe1983fmwu98gh
Accept: application/json
Sample Response
{
"searchinput": {
"searchphrase": "red dress",
"sortorderby": "default",
"perpage": 12,
"page": 1,
"inventoryassortment": "SITE",
"imageWidth": "164",
"upcimagewidth": "164",
"swatchimagewidth": "57",
"application": "ASSOCIATE",
"device": "TABLET",
"country": "us"
},
"totalpages": 14,
"messageFlag": false,
"bopsFacetFlag": false,
"facets": [{
"facetname": "FOB",
"displayname": "Department",
"facetvalues": [{
"value": "Women",
"productcount": 127
}, {
"value": "Kids",
"productcount": 24
}, {
"value": "Plus Sizes",
"productcount": 4
}, {
"value": "Petites",
"productcount": 3
}]
}, {
"facetname": "GENDER_AGE",
"displayname": "Gender/Age",
"facetvalues": [{
"value": "Women",
"productcount": 133
}, {
"value": "Girls",
"productcount": 13
}, {
"value": "Infant Girls",
"productcount": 11
}]
}, {
"facetname": "DRESS_OCCASION",
"displayname": "Occasion",
"facetvalues": [{
"value": "Day",
"productcount": 72
}, {
"value": "Party",
"productcount": 42
}, {
"value": "Evening/Formal",
"productcount": 20
}, {
"value": "Prom",
"productcount": 12
}, {
"value": "Work",
"productcount": 11
}, {
"value": "Lounge",
"productcount": 4
}]
}, {
"facetname": "DRESS_STYLE_M",
"displayname": "Dress Type",
"facetvalues": [{
"value": "Lace",
"productcount": 18
}, {
"value": "Fit & Flare",
"productcount": 17
}, {
"value": "Sequin & Beaded",
"productcount": 11
}, {
"value": "Maxi",
"productcount": 10
}, {
"value": "Sheer Panels",
"productcount": 7
}, {
"value": "Pink",
"productcount": 4
}]
}, {
"facetname": "PRODUCT_DEPARTMENT",
"displayname": "Category",
"facetvalues": [{
"value": "Dresses",
"productcount": 156
}, {
"value": "Swimsuits",
"productcount": 1
}]
}, {
"facetname": "LENGTH_M",
"displayname": "Length",
"facetvalues": [{
"value": "Short",
"productcount": 81
}, {
"value": "Mid",
"productcount": 25
}, {
"value": "Long",
"productcount": 29
}]
}, {
"facetname": "SLEEVE_LENGTH",
"displayname": "Sleeve Length",
"facetvalues": [{
"value": "Sleeveless",
"productcount": 67
}, {
"value": "Short Sleeve",
"productcount": 28
}, {
"value": "Long Sleeve",
"productcount": 22
}, {
"value": "One Shoulder",
"productcount": 5
}, {
"value": "Strapless",
"productcount": 10
}]
}, {
"facetname": "BRAND",
"displayname": "Designer",
"facetvalues": [{
"value": "BCBGMAXAZRIA",
"productcount": 10
}, {
"value": "Free People",
"productcount": 9
}, {
"value": "Ralph Lauren",
"productcount": 9
}, {
"value": "DIANE von FURSTENBERG",
"productcount": 6
}, {
"value": "GUESS",
"productcount": 6
}, {
"value": "Burberry",
"productcount": 5
}, {
"value": "Coast",
"productcount": 5
}, {
"value": "kate spade new york",
"productcount": 5
}, {
"value": "Laundry by Shelli Segal",
"productcount": 5
}, {
"value": "Alice + Olivia",
"productcount": 3
}],
"facetmoreless": "More",
"facetmorelessurl": "/v4/catalog/search?searchphrase=red+dress&facetexpand=designer"
}, {
"facetname": "SIZE_NORMAL",
"displayname": "Size",
"facetvalues": [{
"value": "P",
"productcount": 3
}, {
"value": "P/XS",
"productcount": 1
}, {
"value": "P/S",
"productcount": 1
}, {
"value": "P/M",
"productcount": 1
}, {
"value": "P/L",
"productcount": 1
}, {
"value": "XXS",
"productcount": 2
}, {
"value": "XS",
"productcount": 28
}, {
"value": "XS/S",
"productcount": 1
}, {
"value": "S",
"productcount": 39
}, {
"value": "M",
"productcount": 42
}],
"facetmoreless": "More",
"facetmorelessurl": "/v4/catalog/search?searchphrase=red+dress&facetexpand=size"
}, {
"facetname": "COLOR_NORMAL",
"displayname": "Color",
"facetvalues": [{
"value": "Red",
"productcount": 157
}]
}, {
"facetname": "PRICE",
"displayname": "Price",
"facetvalues": [{
"range": {
"torange": "50",
"fromrange": "0"
},
"productcount": 9
}, {
"range": {
"torange": "100",
"fromrange": "50"
},
"productcount": 31
}, {
"range": {
"torange": "250",
"fromrange": "100"
},
"productcount": 58
}, {
"range": {
"torange": "500",
"fromrange": "250"
},
"productcount": 51
}, {
"range": {
"torange": "1000",
"fromrange": "500"
},
"productcount": 11
}, {
"range": {
"fromrange": "1000"
},
"productcount": 1
}]
}, {
"facetname": "SPECIAL_OFFERS",
"displayname": "Promotions",
"facetvalues": [{
"value": "Sales & Offers",
"productcount": 62
}, {
"value": "Gift with Purchase",
"productcount": 14
}]
}, {
"facetname": "SHOWONLY",
"displayname": "MORE WAYS TO SHOP",
"facetvalues": [{
"value": "New Arrivals",
"productcount": 15
}, {
"value": "Customers' Top Rated",
"productcount": 8
}, {
"value": "Only at Bloomingdale's",
"productcount": 3
}]
}],
"searchresultgroups": [{
"totalproducts": 157,
"products": {
"product": [{
"id": 1048631,
"summary": {
"name": "Coast Gown - Stacie Sequin",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/coast-gown-stacie-sequin?ID=1048631",
"iscollection": false,
"available": true,
"productstartdays": 5
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8531593_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8531593_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8531594_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8531594_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Merlot",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8531594_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8531594_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8531593_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8531593_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 650.0
},
"pricetypeid": 0
},
"category": [{
"id": 2910,
"type": "homecategory"
}],
"badges": {
"promotionbadge": ["Bonus Offer"],
"new": true
}
}, {
"id": 1037419,
"summary": {
"name": "Cynthia Steffe Dress - Think Cap Sleeve Ponte Fit and Flare",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/cynthia-steffe-dress-think-cap-sleeve-ponte-fit-and-flare?ID=1037419",
"iscollection": false,
"available": true,
"productstartdays": 12
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/6/optimized/8523756_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "6/optimized/8523756_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/7/optimized/8523757_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "7/optimized/8523757_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Red Apple",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/7/optimized/8523757_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "7/optimized/8523757_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/6/optimized/8523756_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "6/optimized/8523756_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 248.0
},
"pricetypeid": 0
},
"category": [{
"id": 2910,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1019230,
"summary": {
"name": "Melissa Masse Plus Luxe Print Jersey Maxi Dress",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/melissa-masse-plus-luxe-print-jersey-maxi-dress?ID=1019230",
"iscollection": false,
"available": true,
"productstartdays": 29
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/1/optimized/8513081_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "1/optimized/8513081_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8513082_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8513082_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Bargello Multi",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8513082_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8513082_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/1/optimized/8513081_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "1/optimized/8513081_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 350.0
},
"pricetypeid": 0
},
"category": [{
"id": 2917,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1042839,
"summary": {
"name": "BCBGMAXAZRIA Dress - Victoria Cutout",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/bcbgmaxazria-dress-victoria-cutout?ID=1042839",
"iscollection": false,
"available": true,
"productstartdays": 7
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8527492_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8527492_fpx",
"colorized": true,
"hasMoreColors": true
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8527494_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8527494_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Black",
"color": "Black",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8527494_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8527494_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8527492_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8527492_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0,
"swatchimage": {
"imagetype": "SWATCH",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/swatches/3/optimized/8527493_fpx.tif?wid=57&fmt=jpeg",
"imagename": "3/optimized/8527493_fpx",
"sequenceNumber": 1
}
}, {
"type": "colorwayImage",
"imagetype": "SWATCH",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/swatches/3/optimized/8527493_fpx.tif?wid=57&fmt=jpeg",
"imagename": "3/optimized/8527493_fpx",
"sequenceNumber": 1
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Lipstick Red",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/7/optimized/8527497_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "7/optimized/8527497_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/5/optimized/8527495_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "5/optimized/8527495_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 1,
"swatchimage": {
"imagetype": "SWATCH",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/swatches/6/optimized/8527496_fpx.tif?wid=57&fmt=jpeg",
"imagename": "6/optimized/8527496_fpx",
"sequenceNumber": 1
}
}, {
"type": "colorwayImage",
"imagetype": "SWATCH",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/swatches/6/optimized/8527496_fpx.tif?wid=57&fmt=jpeg",
"imagename": "6/optimized/8527496_fpx",
"sequenceNumber": 1
}],
"price": {
"regular": {
"value": 248.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1042827,
"summary": {
"name": "BCBGMAXAZRIA Dress - Francis Peplum",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/bcbgmaxazria-dress-francis-peplum?ID=1042827",
"iscollection": false,
"available": true,
"productstartdays": 7
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8527463_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8527463_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8527464_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8527464_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Poppy",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8527464_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8527464_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8527463_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8527463_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 338.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1044579,
"summary": {
"name": "GUESS Dress - Printed Lace",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/guess-dress-printed-lace?ID=1044579",
"iscollection": false,
"available": true,
"productstartdays": 7
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8529869_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8529869_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/0/optimized/8529870_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "0/optimized/8529870_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Bright Coral Multi",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/0/optimized/8529870_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "0/optimized/8529870_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8529869_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8529869_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 98.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1038454,
"summary": {
"name": "GUESS Maxi Dress - Baja Floral Leo",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/guess-maxi-dress-baja-floral-leo?ID=1038454",
"iscollection": false,
"available": true,
"productstartdays": 12
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/8/optimized/8524208_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "8/optimized/8524208_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8524209_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8524209_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Bright Coral Multi",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8524209_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8524209_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/8/optimized/8524208_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "8/optimized/8524208_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 118.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1038453,
"summary": {
"name": "GUESS Dress - Baja Floral Leopard",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/guess-dress-baja-floral-leopard?ID=1038453",
"iscollection": false,
"available": true,
"productstartdays": 12
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/6/optimized/8524206_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "6/optimized/8524206_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/7/optimized/8524207_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "7/optimized/8524207_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Bright Coral Multi",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/7/optimized/8524207_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "7/optimized/8524207_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/6/optimized/8524206_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "6/optimized/8524206_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 98.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1012465,
"summary": {
"name": "DIANE von FURSTENBERG Dress - Jeannie Fit and Flare",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/diane-von-furstenberg-dress-jeannie-fit-and-flare?ID=1012465",
"iscollection": false,
"available": true,
"productstartdays": 25
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/0/optimized/8506780_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "0/optimized/8506780_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/1/optimized/8506781_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "1/optimized/8506781_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Chili Pepper",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/1/optimized/8506781_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "1/optimized/8506781_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/0/optimized/8506780_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "0/optimized/8506780_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 365.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1012464,
"summary": {
"name": "DIANE von FURSTENBERG Dress - Rebecca Knit",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/diane-von-furstenberg-dress-rebecca-knit?ID=1012464",
"iscollection": false,
"available": true,
"productstartdays": 25
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/8/optimized/8506778_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "8/optimized/8506778_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8506779_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8506779_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Chili Pepper",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/9/optimized/8506779_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "9/optimized/8506779_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/8/optimized/8506778_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "8/optimized/8506778_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 425.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 1012461,
"summary": {
"name": "DIANE von FURSTENBERG Maxi Dress - Annie Silk",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/diane-von-furstenberg-maxi-dress-annie-silk?ID=1012461",
"iscollection": false,
"available": true,
"productstartdays": 25
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8506772_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8506772_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"imagetype": "ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8506773_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8506773_fpx"
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Chili Pepper",
"upcadditionalimage": [{
"imagetype": "UPC_ADDITIONAL_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/3/optimized/8506773_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "3/optimized/8506773_fpx",
"sequenceNumber": 1
}],
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/2/optimized/8506772_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "2/optimized/8506772_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 565.0
},
"pricetypeid": 0
},
"category": [{
"id": 2911,
"type": "homecategory"
}],
"badges": {
"new": true
}
}, {
"id": 978299,
"summary": {
"name": "Jacadi Girls' Seersucker Dress - Sizes 2-10",
"producttype": "DRESS",
"onsale": false,
"producturl": "http://www1.bloomingdales.com/shop/product/jacadi-girls-seersucker-dress-sizes-2-10?ID=978299",
"iscollection": false,
"available": true,
"productstartdays": 73
},
"image": [{
"imagetype": "PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8482964_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8482964_fpx",
"colorized": true,
"hasMoreColors": false
}, {
"type": "colorwayImage",
"imagetype": "COLORWAY",
"colornormal": "Red",
"color": "Blanc/Rose",
"upcprimaryimage": {
"imagetype": "UPC_PRIMARY_IMAGE",
"imageurl": "http://images.bloomingdales.com/is/image/BLM/products/4/optimized/8482964_fpx.tif?bgc=255,255,255&wid=164&qlt=90&layer=comp&op_sharpen=0&resMode=bicub&op_usm=0.7,1.0,0.5,0&fmt=jpeg",
"imagename": "4/optimized/8482964_fpx",
"sequenceNumber": 1
},
"swatchsequencenumber": 0,
"swapoutsequencenumber": 0
}],
"price": {
"regular": {
"value": 109.0
},
"pricetypeid": 0
},
"category": [{
"id": 3866,
"type": "homecategory"
}],
"badges": {
"new": false
}
}]
}
}]
}
Error Codes
Call Specific Error Codes:
NONE
General Error Handling Documentation:
Docs Navigation
- Overview
- Customer Services
- Loyalty Services
- customer v1 user profile services
- Common API Characteristics
- Ad Media
- Catalog and Store Services
- Order Services
- Mobile Utilities
- Promotion and Coupon Services
- Registry Services
- Store Services
- Error Handling
- Deprecated Services
- What's New
- Bloomingdale's API FAQ
- Quick Start Guide
- BOPS Stores
- user