v4 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.
Product Recommendations By Store v4 The Product Recommendations by Store v4 endpoint provides product recommendations to users based on their store location.
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 v4 Visual Search API allows users to search for an 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.

Docs Navigation