Assortment Recommendations

Assortment growth recommendations are uniquely designed to give your business a competitive edge. Using customer demand signals, category data, and more, this capability gives you an opportunity to expand your Marketplace listings with the help of recommendations for popular brands and items.

Take the guesswork out of selling

Get personalised recommendations that’ll help grow your catalog and boost sales. You may even see items that aren’t available on Walmart.com, giving you that extra edge over the competition!

Find exactly what you need

Seamlessly filter by price, category, or brand to find the exact information you want.

Set everything up effortlessly

Save time and add desired suggested items immediately with our Item set up APIs.

You can fetch the list of recommendations created for you by using the Get Recommendations API. Use ITEM as the recommendationType.

You can fetch all recommendations created for you or add filterCriteria such as searchText, multiValueFilter, enumFilter and rangeFilter to fetch a specific set of recommendations. All of the filters are connected using the AND operator.

searchText

You can filter using a search term that contains any phrase that could be found anywhere in the recommendations data. The term must not be empty and must have at least three characters. This would filter for the search term present anywhere in the recommendation data. 

multiValueFilter

This can be used to filter based on a certain parameter. Currently, the parameters supported are BRAND and CATEGORY. Maximum of 7 data can be sent in the list of values connected to the parameter. There shouldn’t be any empty or null values. When applying a multiValueFilter, the OR operator is used between the values. 

enumFilter

This can be used to filter based on preset parameters and their associated values. Currently, the parameter supported is ITEM_AVAILABILITY_STATUS which defines whether the item is currently available on Walmart or is new to Walmart. The corresponding values for this parameter are EXISTING_IN_WALMART, NEW_TO_WALMART

rangeFilter

This can be used to filter based on a range. You must pass a parameter with floor range value or ceiling range value or both values. Currently, the support parameter value is PRICE for the rangeFilter. The range filter for price is applied on Walmart item prices and/ or competition item prices to fetch the corresponding recommendations.

You can fetch the list of Brands and Categories of the item recommendations that are recommended for you by using the Get Categorization API. You can currently use BRAND or CATEGORY as the categorizationType. 

BRAND as a type of categorization

• Here you can get the list of brands sorted by the number of item recommendations associated with it. This is then sorted in lexicographic order of brand name. 
• You can also add filterCriteria such as searchText and multiValueFilter to get a specific set of results.
• You will be able to pull a maximum of 200 records in one response and use nextCursor to pull the next set of records

CATEGORY as a type of categorization

• Here you can get the list of categories sorted by the number of item recommendations associated with it. This is then sorted in lexicographic order of category name. 
• You can add filterCriteria like searchText and multiValueFilter to get specific set of results.
• You will be able to pull a maximum of 200 records in one response and use nextCursor to pull the next set of records

You can bulk download the item recommendations created for you by using the set of three APIs listed below. You can use ITEM as the recommendationType.

You can download all recommendations (subject to a maximum limit of 50k in one response) created for you or add filterCriteria such as searchText, multiValueFilter, enumFilter and rangeFilter to get a specific set of results. The recommendations can be downloaded using the following APIs-

Create download request API

• You can create a new download request by using the Download Recommendations API.
• The response for this API would provide a requestId which you can use in subsequent APIs to fetch the request status and download URL.
• You can create a maximum of two download requests in an hour.
• It may take 15-30 mins to generate the file after the download request is created.

Get download request status API

• You can fetch the status of the download request for a specific requestId by using the Get Download Request Status API.
• The different statuses for a download request include RECEIVED, INPROGRESS, READY, ERROR.
• When the request status changes to READY, you can fetch the download URL using the Get download URL API.

Get download URL API

• You can fetch the URL to download the file for a specific requestId by using the Get Download URL API. 
• You can fetch the download URL for the request created in the last 30 days only.
• Once the URL is fetched, it will be active for 15 mins during which the user should download the file. If the user fails to download within the 15 mins, a new download URL could be fetched using this api again. 
• The downloaded file will have the following data attributes-

Attribute	Description
Item Recommendation Unique Id	Unique ID assigned to each recommended item that can used to reject the recommendations
Item name	Name of the recommended item
Brand	Brand of the recommended item
Category	Category of the recommended item
Price Currency	Currency in which item prices are shown
Item Availability Status	Highlights whether the recommended item is new to Walmart or is an existing item on Walmart. Corresponding values can be EXISTING_IN_WALMART, NEW_TO_WALMART
GTIN	GTIN of the recommended item
UPC	UPC of the recommended item
ISBN	ISBN of the recommended item
EAN	EAN of the recommended item
Walmart Item ID	Item ID of the recommended item on Walmart. It will be populated if it is an existing item on Walmart. This can be used to set up the item using Item Set up by Match APIs
Walmart URL	URL of the recommended item on Walmart. It will be populated if it is an existing item on Walmart.
Walmart item price	Price of the recommended item on Walmart. It will be populated if it is an existing item on Walmart.
Walmart Shipping Price	Shipping Price of the recommended item on Walmart. It will be populated if it is an existing item on Walmart.
Walmart Total Price	Total Price (Item Price + Shipping Price) of the recommended item on Walmart. It will be populated if it is an existing item on Walmart.
WFS Indicator	Highlights if the recommended item is eligible to be on WFS on Walmart.
Competitor item ID	Item ID of the recommended item on a competitor marketplace.
Competitor URL	URL of the recommended item on a competitor marketplace.
Competitor Item Price	Price of the recommended item on a competitor marketplace.
Competitor Shipping Price	Shipping Price of the recommended item on a competitor marketplace.
Competitor Total Price	Total Price (Item Price + Shipping Price) of the recommended item on a competitor marketplace.

You can reject the list of recommendations that are recommended for you by using the Reject Recommendations API. This will act as a feedback loop and help us generate better recommendations for you in the future. 

Use ITEM as the recommendationType. The recommendations can be rejected by selecting appropriate filterCriteria such as searchText, multiValueFilter, enumFilter and rangeFilteror by providing a list of itemRecommendationUniqueId. You will need to provide valid rejection code(s) while submitting the reject request. Possible rejection code values include-

rejection code	Description
NOT_SELLING_THESE_ITEMS	As a seller, I don’t intend to sell these items on Walmart
NOT_SELLING_THESE_BRANDS	As a seller, I don’t intend to sell these brands on Walmart
NOT_SELLING_THESE_CATEGORIES	As a seller, I don’t intend to sell these categories on Walmart
LIMITED_TO_OTHER_MARKETPLACE	As a seller, I intend to sell the rejected items only on other marketplaces
ALREADY_SELLING_ON_WALMART	I am already selling these items on Walmart
OTHER_REASON	Mandatory to add customRejectionMessage