Category and Product Services

 

The Catalog and Product Services are designed to return Macy's Category and Product information.

Methods Available

Category and Product Services v4

Method NameDescription
Category Index v4 This service provides a list of all the active categories (or whichever categories are specified) in a hierarchical tree that can be navigated in either direction.
Category Brand Index v4
This API allows users to specify Category(s) and retrieve the complete list of Brands for that Category(s).  This is called the Brand Index.
Product Detail (Using Product ID) v4
The V4 Product service can retrieve highly customizable detailed descriptions of a particular product by using Product IDs. The URL and response have changed greatly from V3 to V4 in that it follows a nested object logical pattern.
Product Detail  (Using UPC) v4 The V4 Product service can retrieve highly customizable detailed descriptions of a particular product by using UPC IDs. The URL and response have changed greatly from V3 to V4 in that it follows a nested object logical pattern.
Product Recommendations v4 The Product recommendations service allows you to specify a product and return related products that are recommended just as is done on Macys.com.
BOPS Product Availability (Using Product ID) v4 The V4 BOPS (Buy Online Pick-up in Store) Product Availability service allows you specify a Product ID and return the products BOPS availability at a nearby store using zipcode, city-state, or locationnumber.
BOPS Product Availability (Using UPC ID) v4 The V4 BOPS (Buy Online Pick-up in Store) Product Availability service allows you specify a UPC ID and return the products BOPS availability at a nearby store using zipcode, city-state, or locationnumber.

Visual Search V4 The Visual Search V4 API is used for searching by image itself. The user uploads a picture from a mobile device and passes this image within some additional parameters to search for similar images in Macy's catalog. This service will return list of similar product with their IDs and thumbnail information about those products.

Category and Product Services v3

Method NameDescription
Category Index v3 This API provides an option to obtain all the categoryIDs in a hierarchical structure by making a call with the ‘index’ parameter.
Category Browse v3 The Category Browse service can retrieve information on the hierarchy of product categories as on Macys.com. In addition to the hierarchy details such as category description, Product IDs within the category & facets that can appear for those products can be retrieved.The API enables users to obtain category details by specifying a category ID
Category Browse Product v3 Within the Category Product Browse service allosw users to browse the products in a specific category.
Product Index v3

This API provides an option to obtain all the categoryIDs in a hierarchical structure by making a call with the ‘index’ parameter.

Product Detail (Using Product ID) v3

The Product service can retrieve information on detailed description of a particular product by using Product IDs

Product Detail  (Using UPC) v3

The Product service can retrieve information on detailed description of a particular product by using UPC's 

 

Catalog (MSP)

Method NameDescription
Countries This service provides a list of all the active categories (or whichever categories are specified) in a hierarchical tree that can be navigated in either direction.

Docs Navigation