Overview

The Get recommendations API provides you with suggestions about what to sell on Walmart Marketplace based on market trends, customer-favorite items, new high demand items over the past 30 days, and gaps in your product availability.

Endpoint

POST https://marketplace.walmartapis.com/v3/growth/assortment/recommendations

Functionality

This call helps you:

To become aware of items in high demand
Identify top products
Learn your customers’ top go get items in the past 30 days
Find recent recommendations
Monitor keyword search trends
Get competitive benchmarking data

Request sample All item recommendations

curl --request POST \ --url https://marketplace.walmartapis.com/v3/growth/assortment/recommendations \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "recommendationType": "ITEM", "meta": { "limit": 2 }
}
'

import requests url = "https://marketplace.walmartapis.com/v3/growth/assortment/recommendations" headers = { "accept": "application/json", "content-type": "application/json", # Include your auth + required Walmart headers as applicable in your integration.
} payload = { "recommendationType": "ITEM", "meta": {"limit": 2}
} resp = requests.post(url, headers=headers, json=payload, timeout=30)
resp.raise_for_status()
print(resp.json())

Request sample Item recommendations based on filter


curl --request POST \ --url https://marketplace.walmartapis.com/v3/growth/assortment/recommendations \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "recommendationType": "ITEM", "meta": { "limit": 4, "nextCursor": "AoRYPgVANXFt6AeR8QUAAAAAAAAAADkxMDEwMDMwNTZBTkRBTkRCMDg3WVYxOU05" }, "filterCriteria": { "searchText": "and", "multiValueFilter": [ { "parameter": "BRAND", "values": [ "Disney", "NINTENDO" ] }, { "parameter": "CATEGORY", "values": [ "Toys" ] }, { "parameter": "PRODUCT_TYPE", "values": [ "Action Figure Sets", "Power Tool Batteries", "Action Figures" ] } ], "enumFilter": [ { "parameter": "ITEM_AVAILABILITY_STATUS", "values": [ "NEW_TO_WALMART", "EXISTING_IN_WALMART" ] }, { "parameter": "SHOPPING_TRENDS", "values": [ "MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS" ] }, { "parameter": "DEMAND_SALES_TRENDS", "values": [ "DEC", "APR", "NOV", "MAR" ] } ], "rangeFilter": [ { "parameter": "PRICE", "from": "1.0", "to": "3.5" } ], "isTopGoGetItem": true, "isNewRecommendation": true }
}
'

import requests url = "https://marketplace.walmartapis.com/v3/growth/assortment/recommendations" headers = { "accept": "application/json", "content-type": "application/json", # Include your auth + required Walmart headers as applicable in your integration.
} payload = { "recommendationType": "ITEM", "meta": {"limit": 2}
} resp = requests.post(url, headers=headers, json=payload, timeout=30)
resp.raise_for_status()
print(resp.json())

Modify your code

1. Add authentication headers

Include required Walmart Marketplace authentication headers such as:

OAuth access token
Consumer ID (if applicable)
Correlation ID

Example additions:

--header 'Authorization: Bearer <ACCESS_TOKEN>' \ --header 'WM_CONSUMER.ID: <CONSUMER_ID>' \ --header 'WM_QOS.CORRELATION_ID: <unique-id>'

import requests url = "https://marketplace.walmartapis.com/v3/growth/assortment/recommendations" headers = { "accept": "application/json", "content-type": "application/json", # Include your auth + required Walmart headers as applicable in your integration.
} payload = { "recommendationType": "ITEM", "meta": {"limit": 2}
} resp = requests.post(url, headers=headers, json=payload, timeout=30)
resp.raise_for_status()
print(resp.json())

2. Control pagination

The response contains:

limit
recordsFetched
totalRecords
nextCursor

To retrieve additional records:

Include the returned nextCursor in the next request (if supported in your implementation)
Adjust meta.limit to control page size

3. Apply filters

To retrieve filtered recommendations:

Add filter parameters in the request body
Narrow results by category, availability status, or business strategy
Use cursor-based pagination to iterate filtered results
Use the filterCriteria parameter to pass in searchText, multiValueFilter, enumFilter, and rangeFilter to generate specific types of recommendations, and boolean filters such as isTopGoGetItem and ``isNewRecommendation

4. Parse recommendation data

For each record in payload.records:

Use itemRecommendationUniqueId for tracking
Extract itemDetails including demand, pricing, trends, and competitor data
Prioritize items with:
- isTopGoGetItem = true
- A high rating
- A potentialSalesRank

Response sample – All item recommendations

{ "payload": { "recommendationType": "ITEM", "meta": { "totalRecords": 7, "recordsFetched": 2, "limit": 2, "nextCursor": "FGluY2x1ZGVfY29udGV4dF91dWlkDXF1ZXJ5QW5kRmV0Y2gBFmFvVTU3ZXNnUktHbjNxeUJHVHJ6VHcAAAAAAAApuhZqRkg2QURYNFFGR29ZMndCRnp4eEl3" }, "records": [ { "itemRecommendationUniqueId": "552855525", "itemDetails": { "title": "Disney Mirrorverse 5\" Figure WV1 - Sulley", "brand": "Disney", "category": "Toys", "productType": "Action Figures", "gtin": "00787926160345", "upc": "78792616034", "ean": "0787926160345", "itemAvailabilityStatus": "EXISTING_IN_WALMART", "potentialSales": "$0-$10K", "potentialSalesRank": 9, "isTopGoGetItem": false, "shoppingTrends": [ "Most searched for" ], "demandSalesTrends": [ "DEC", "APR", "NOV", "MAR" ], "searchKeywords": [ "MINIVERSE", "MINIVERSE HOLIDAY", "MINVERSE", "SULLEY", "MIRRORVERSE" ], "offerCount": 12, "freeShipping": "YES", "rating": 4.5, "ratingCount": 67, "primaryVariantItemId": "B0CW3VWC3X", "hasVariants": true, "walmart": { "itemId": "552855525", "itemPrice": { "amount": 2.3, "currency": "USD" }, "shippingPrice": { "amount": 0, "currency": "USD" } }, "competitors": [ { "itemId": "B08X954CCW", "url": "www.amazon.com/dp/B08X954CCW" } ] } }, { "itemRecommendationUniqueId": "B016GASDD8", "itemDetails": { "title": "Animal Crossing Happy Home Designer Amiibo Card Sterling 048/100", "brand": "NINTENDO", "category": "Toys", "productType": "Action Figures", "itemAvailabilityStatus": "NEW_TO_WALMART", "potentialSales": "$0-$10K", "potentialSalesRank": 9, "isTopGoGetItem": true, "shoppingTrends": [ "Most searched for" ], "demandSalesTrends": [ "DEC", "APR", "NOV", "MAR" ], "searchKeywords": [ "raymond amiibo", "raymond amiibo card" ], "offerCount": 10, "freeShipping": "NO", "rating": 4.3, "ratingCount": 16, "hasVariants": false, "competitors": [ { "itemId": "B016GASDD8", "url": "www.amazon.com/dp/B016GASDD8", "itemPrice": { "amount": 2.95, "currency": "USD" }, "shippingPrice": { "amount": 0.5, "currency": "USD" } } ] } } ] }
}

Response sample – Items recommendations based on filter

{ "payload": { "recommendationType": "ITEM", "meta": { "totalRecords": 7, "recordsFetched": 2, "limit": 2, "nextCursor": "FGluY2x1ZGVfY29udGV4dF91dWlkDXF1ZXJ5QW5kRmV0Y2gBFmFvVTU3ZXNnUktHbjNxeUJHVHJ6VHcAAAAAAAApuhZqRkg2QURYNFFGR29ZMndCRnp4eEl3" }, "records": [ { "itemRecommendationUniqueId": "552855525", "itemDetails": { "title": "Disney Mirrorverse 5\" Figure WV1 - Sulley", "brand": "Disney", "category": "Toys", "productType": "Action Figures", "gtin": "00787926160345", "upc": "78792616034", "ean": "0787926160345", "itemAvailabilityStatus": "EXISTING_IN_WALMART", "potentialSales": "$0-$10K", "potentialSalesRank": 9, "isTopGoGetItem": false, "shoppingTrends": [ "Most searched for" ], "demandSalesTrends": [ "DEC", "APR", "NOV", "MAR" ], "searchKeywords": [ "MINIVERSE", "MINIVERSE HOLIDAY", "MINVERSE", "SULLEY", "MIRRORVERSE" ], "offerCount": 10, "freeShipping": "YES", "rating": 4.7, "ratingCount": 71, "primaryVariantItemId": "B0CW3VWC3X", "hasVariants": true, "walmart": { "itemId": "552855525", "itemPrice": { "amount": 2.3, "currency": "USD" }, "shippingPrice": { "amount": 0, "currency": "USD" } }, "competitors": [ { "itemId": "B08X954CCW", "url": "www.amazon.com/dp/B08X954CCW" } ] } }, { "itemRecommendationUniqueId": "B016GASDD8", "itemDetails": { "title": "Animal Crossing Happy Home Designer Amiibo Card Sterling 048/100", "brand": "NINTENDO", "category": "Toys", "productType": "Action Figures", "itemAvailabilityStatus": "NEW_TO_WALMART", "potentialSales": "$0-$10K", "potentialSalesRank": 9, "isTopGoGetItem": false, "shoppingTrends": [ "Most searched for" ], "demandSalesTrends": [ "DEC", "APR", "NOV", "MAR" ], "searchKeywords": [ "raymond amiibo", "raymond amiibo card" ], "offerCount": 10, "freeShipping": "NO", "rating": 3.9, "ratingCount": 23, "primaryVariantItemId": "B0CW3VWC3X", "hasVariants": false, "competitors": [ { "itemId": "B016GASDD8", "url": "www.amazon.com/dp/B016GASDD8", "itemPrice": { "amount": 2.95, "currency": "USD" }, "shippingPrice": { "amount": 0.75, "currency": "USD" } } ] } } ] }
}

Result

The Get recommendations API provides curated recommendations to grow your assortment.
Responses provide:
- A paginated list of recommended items
- Unique recommendation IDs
- Product-level details (brand, category, GTIN, trends)
- Sales potential indicators
- Competitor data
- Walmart catalog availability
- Variant indicators
- Cursor token for pagination

Next steps

Get variants API: Lists customer favorite preferences such as size, color, or material.
- Get variants API Guide
- Get variants API Reference Guide
Get categorization API: Provides a primary sort of the brands by recommendation count, then a secondary sort in alphabetical order.
- Get categorization API Guide
- Get categorization API Reference Guide
Reject recommendations API: Lets you reject items Walmart recommends. If you reject a recommended item, you won’t see it again.
- Reject recommendations API Guide
- Reject recommendations API Reference Guide
Get recommendation trends API: Provides trend data about your assortment on Walmart, including price and demand trends, so you can respond quickly to maintain a competitive edge. 
- Get recommendation trends API Guide
- Get recommendation trends API Reference Guide