• Register

Category Ad Media 2.0

Description

The Category Ad Media Service is a read only resource that returns all the media information for a given category Id.

HTTP Method and Request URL

GET

https://api.bloomingdales.com/v2/admedia/category?categoryId=1001038&channel=SITE

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-bloomingdales-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

categoryId

Specify one or more category Id's separated by comma. A list of Category ID's can be pulled by making a Category Index call

Yes categoryId=1001038
channel Channel can be either SITE or REGISTRY
Yes
channel=SITE
secure By default this is set to false. If set to true links in response will be https NOT http No
true or false
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 Request and Response

Sample Request

Request URL:

GET

 https://api.bloomingdales.com/v2/admedia/category?categoryId=1001038&channel=SITE

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

Sample Response

{
    "mediaPoolMapper": {
        "mediaPoolItem": [{
            "poolName": "4013118_ROW101AD1",
            "mediaItemMapper": {
                "mediaItem": [{
                    "filename": "/copyblock/2013/11/520841.jsp",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash//copyblock/2013/11/520841.jsp",
                    "height": 0,
                    "width": 0,
                    "text": "new arrivals contemp",
                    "description": "new arrivals contemp",
                    "mediaGroupType": "COPY_BLOCK",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "520841"
                }]
            }
        }, {
            "poolName": "526380",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Tees %26 Sweatshirts|Tops,ORIGINAL,96?id=1001038",
                            "fullLinkURL": "http://www1.bloomingdales.com/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Tees %26 Sweatshirts|Tops,ORIGINAL,96?id=1001038"
                        }]
                    },
                    "filename": "NEWARRIVALS_TOPSANDTEES.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/NEWARRIVALS_TOPSANDTEES.jpg",
                    "height": 270,
                    "width": 742,
                    "text": "",
                    "description": "CO_NEWARRIVALS_TOPSandTEES",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526380"
                }]
            }
        }, {
            "poolName": "4004947_ROW101AD1",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526815",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "525814",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526678",
                            "fullLinkURL": ""
                        }]
                    },
                    "filename": "THUMBNAIL_GRID",
                    "fullImageURL": "",
                    "height": 0,
                    "width": 0,
                    "text": "",
                    "description": "",
                    "mediaGroupType": "AD",
                    "mediaType": "THUMBNAIL_GRID"
                }]
            }
        }, {
            "poolName": "526815",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/fashion-index/sunset-spring-2014.jsp",
                            "fullLinkURL": "http://www1.bloomingdales.com/fashion-index/sunset-spring-2014.jsp"
                        }]
                    },
                    "filename": "SS_MediaAd.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/SS_MediaAd.jpg",
                    "height": 295,
                    "width": 236,
                    "text": "",
                    "description": "SS_MediaAd",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526815"
                }]
            }
        }, {
            "poolName": "525814",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/fashion-index/womens-denim-fit-guide/the-real-deal.jsp",
                            "fullLinkURL": "http://www1.bloomingdales.com/fashion-index/womens-denim-fit-guide/the-real-deal.jsp"
                        }]
                    },
                    "filename": "S14_Denim-Seeker_Media-Ad_3.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/S14_Denim-Seeker_Media-Ad_3.jpg",
                    "height": 297,
                    "width": 238,
                    "text": "",
                    "description": "MEDIA AD_Real Deal ",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "525814"
                }]
            }
        }, {
            "poolName": "526382",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Swim,ORIGINAL,96?id=1001038",
                            "fullLinkURL": "http://www1.bloomingdales.com/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Swim,ORIGINAL,96?id=1001038"
                        }]
                    },
                    "filename": "NEWARRIVALS_SWIM.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/NEWARRIVALS_SWIM.jpg",
                    "height": 270,
                    "width": 742,
                    "text": "",
                    "description": "CO_NEWARRIVALS_SWIM",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526382"
                }]
            }
        }, {
            "poolName": "526376",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Dresses,ORIGINAL,96?id=1001038",
                            "fullLinkURL": "http://www1.bloomingdales.com/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Dresses,ORIGINAL,96?id=1001038"
                        }]
                    },
                    "filename": "NEWARRIVALS_DRESSES.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/NEWARRIVALS_DRESSES.jpg",
                    "height": 270,
                    "width": 742,
                    "text": "",
                    "description": "CO_NEWARRIVALS_DRESSES",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526376"
                }]
            }
        }, {
            "poolName": "4018644_ROW101AD1",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526638",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526376",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526380",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526382",
                            "fullLinkURL": ""
                        }, {
                            "coordinates": "",
                            "text": "",
                            "linkType": "MEDIA",
                            "value": "526378",
                            "fullLinkURL": ""
                        }]
                    },
                    "filename": "2051282.fpx",
                    "fullImageURL": "",
                    "height": 270,
                    "width": 742,
                    "text": "",
                    "description": "",
                    "mediaGroupType": "SLIDESHOW",
                    "mediaType": "TEXT",
                    "mediaGroupId": "526393"
                }]
            }
        }, {
            "poolName": "526378",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "",
                            "text": "",
                            "linkType": "STATIC",
                            "value": "/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Denim,ORIGINAL,96?id=1001038",
                            "fullLinkURL": "http://www1.bloomingdales.com/shop/contemporary-apparel/new-arrivals/Womens_apparel_type,Sortby,Productsperpage/Denim,ORIGINAL,96?id=1001038"
                        }]
                    },
                    "filename": "NEWARRIVALS_DENIM.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/NEWARRIVALS_DENIM.jpg",
                    "height": 270,
                    "width": 742,
                    "text": "",
                    "description": "CO_NEWARRIVALS_DENIM",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526378"
                }]
            }
        }, {
            "poolName": "4005025_OP_BANNER",
            "mediaItemMapper": {
                "mediaItem": [{
                    "filename": "SkinnySubcatBlank_1px.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/SkinnySubcatBlank_1px.jpg",
                    "height": 1,
                    "width": 728,
                    "text": "",
                    "description": "1PixelBlankBanner",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "509424"
                }]
            }
        }, {
            "poolName": "526678",
            "mediaItemMapper": {
                "mediaItem": [{
                    "mediaLinkMapper": {
                        "mediaLinkItem": [{
                            "coordinates": "0,0,243,291",
                            "text": "Prom: Shop the Lookbook",
                            "linkType": "STATIC",
                            "value": "/fashion-index/prom-2014.jsp?",
                            "fullLinkURL": "http://www1.bloomingdales.com/fashion-index/prom-2014.jsp?"
                        }]
                    },
                    "filename": "march_prom.jpg",
                    "fullImageURL": "http://assets.bloomingdales.com/navapp/dyn_img/cat_splash/march_prom.jpg",
                    "height": 297,
                    "width": 238,
                    "text": "",
                    "description": "march_prom",
                    "mediaGroupType": "AD",
                    "mediaType": "IMAGE",
                    "mediaGroupId": "526678"
                }]
            }
        }]
    }
}    

back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation