• Register

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

back to top

 HTTP Method and Request URL

GET

 https://api.bloomingdales.com/v4/catalog/search?searchphrase=keyword search 

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

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]
Note: We do not allow whildcare "*" for upward PRICE queries. For example: PRICE=[50TO*]

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)

  1. If facet has less than 10 values, do not populate output schema attributes of facetMoreLess or facetMoreLessUrl.
  2. 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]
  3. 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.

back to top

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

back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation