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 Name | Description |
|---|---|
| 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 Name | Description |
|---|---|
| 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 Name | Description |
|---|---|
| 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
- Overview
- Customer Services
- Common API Characteristics
- Ad Media
- Catalog Services
- Order Services
- Mobile Utilities
- Promotion and Coupon Services
- Registry Services
- Review Services
- Store Services
- User Services
- Error Handling
- Deprecated Services
- Macy's API FAQ
- BOPS Stores
- What's New