The Get Recommendations API retrieves item recommendations for sellers based on customer demand information.
The default API call retrieves all recommendations, however the filterCriteria parameter can be used to pass in searchText, multiValueFilter, enumFilter, and rangeFilter to generate specific types of recommendations. To request multiple types of recommendations, use the AND operator to append multiple filterCriteria parameter values to the API call.

Throttling

GET Recommendations API Rate Limit: 500 API calls per seller per hour

searchText

The searchText parameter value filters the recommendation results for recommendations that contain the specified search phrase.

Requirements:

• The phrase must not be empty.
• The phrase must have at least three characters.

multiValueFilter

The multiValueFilter parameter value filters the recommendation result with three possible value types: BRAND, CATEGORY, and PRODUCT_TYPE.

Requirements

• You can add a maximum of seven values to the API call.
• The values must not be empty or null.
• You must use the OR operator between each value.

enumFilter

The enumFilter parameter value filters the recommendation results based on preset parameters and associated values.

Below are all supported parameter values:

• ITEM_AVAILABILITY_STATUS: Defines if an item is currently in Walmart or if it’s a new item. This parameter supports the below values:

  • EXISTING_IN_WALMART
  • NEW_TO_WALMART

• SHOPPING_TRENDS: Identifies an item’s demand type in the market. Each item could have more than one value. This parameter supports the below values:

  • MOST_SEARCHED_FOR
  • BEST_SELLERS
  • DEAL_ITEMS

• DEMAND_SALES_TRENDS: Filters customer favorites based on the monthly demands. This filter could have multiple values. Below are all possible filter values:

  JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC

rangeFilter

The rangeFilter parameter value uses a range to filter recommendation results.

Requirements

• You must pass a parameter with a floor range, ceiling range, or both value types.
• The rangeFilter parameter supports only PRICE as the value.
• To fetch corresponding recommendations, the range filter for price is applied on Walmart item prices and/or competition item prices.