Product Recommendation API

The Product recommendation API is an extension driven by the science that powers the recommended products container on Walmart.com. We have parsed 100s of millions of transactions over our product catalog of more than 6 million products to be able to deliver, with accuracy, the items in this response. Some example use cases where a partner might be interested in utilizing this data:

  • A recommended products advertising widget via e-mail delivered right after a transaction has been verified
  • Retargeting on an ecommerce storefront anchored on a shared UPC between multiple merchants
  • An upsell to an existing customer presenting an array of products due to knowing their order history

The endpoint returns a maximum of 10 item responses, being ordered from most relevant to least relevant for the customer.

Next Best Products on Walmart

Each item on Walmart.com has a particular item ID associated with it. This can be generally seen in the last 8 digits of a URL string (see above), but can also be acquired by using the Product Lookup API. Once you have a particular products' Item ID, you can hit the endpoint as follows:

Endpoint:

http://api.walmartlabs.com/v1/nbp?apiKey={apiKey}&itemId={itemID}

 

Example call:

$curl http://api.walmartlabs.com/v1/nbp?apiKey={apiKey}&itemId={itemID}

 

So, if you wanted to see the top 10 recommended products for an Xbox One console sold by Walmart, which has an item ID of 36904791:

$curl http://api.walmartlabs.com/v1/nbp?apiKey={apiKey}&itemId=36904791

Example response:

{

    "itemId": 24928931,

    "parentItemId": 24928931,

    "name": "Watch Dogs (Xbox One)",

    "msrp": 99.96,

    "salePrice": 48.85,

    "upc": "008888538042",

    "categoryPath": "Video Games/Games",

    "shortDescription": "In today's hyper-connected world, Chicago has the country's most advanced computer system - one which controls almost every piece of city technology and holds key information on all of the city's residents. You play as Aiden Pearce, a brilliant hacker, whose criminal past lead to a violent family tragedy. Now on the hunt for those who hurt your family, you'll be able to monitor and hack all who surround you while manipulating the city's systems to stop traffic lights, detonate gas lines, turn off the electrical grid and more. Use the city of Chicago as your ultimate weapon and exact your own style of revenge.",

    "longDescription": "<ul><li>Hack the City - Control the city's infrastructure, in real time, with Aiden's cell phone. Trap your enemy in a 30-car pileup by manipulating the traffic lights. Stop a train, and then board it to evade the authorities. Narrowly escape capture by quickly raising a drawbridge. Anything connected to the city's CTOS can become your weapon.</li><li>Seamless Multiplayer Experience - Discover a new level of interaction, cooperation and confrontation between players thanks to a brand new multiplayer game system that links the single and multiplayer modes into one seamless experience. That means no menus, no loading screens, just instant open world multiplayer action.</li><li>Stay Connected With A New Way To Play - Go beyond the console with a ground-breaking, real-time, companion game. This innovative mobile platform allows players to connect and compete with friends, even when away from the home console. The Watch Dogs companion game delivers revolutionary dual-screen gameplay that enables you to play from anywhere, at any time.</li><li>Street Justice - Create your own way to attack. Take down enemies by delivering devastating blows with your baton, or use combination of shooting and hacking to gain advantage in a situation. Overall, you will have access to more than 30 weapons that rival any shooter.</li><li>High Octane Driving - Get behind the wheel of more than 65 vehicles bursting with horsepower to explore the massive city while completing missions. Ubisoft Montreal partnered with Ubisoft Reflections, the acclaimed studio behind the award-winning Driver series to develop each vehicle with state-of-art physics and handling.</li><li>Everything is Under Control - Experience the advanced processing and graphics capabilities of Disrupt, the all-new game engine dedicated to Watch Dogs. The engine delivers stunning visuals and an incredibly realistic experience. Disrupt gives you the power to affect the story, the city and the life of the population with your choices, creating a ripple effect throughout the city.</li><li>Dynamic Navigation - Watch Dogs gives you the ability to not only use the city's ctOS to your advantage, but the streets as well. In real-world Chicago, cut through one of the buildings or climb to the rooftops to catch your target.</li><li>ESRB Rating: MATURE with Blood, Strong Language, Nudity, Strong Sexual Content, Use of Drugs and Alcohol, and Intense Violence</li></ul>",

    "brandName": "Ubisoft",

    "thumbnailImage": "http://i.walmartimages.com/i/p/00/00/88/88/53/0000888853804_100X100.jpg",

    "mediumImage": "http://i.walmartimages.com/i/p/00/00/88/88/53/0000888853804_180X180.jpg",

    "largeImage": "http://i.walmartimages.com/i/p/00/00/88/88/53/0000888853804_500X500.jpg",

    "productTrackingUrl": "http://linksynergy.walmart.com/fs-bin/click?id=|LSNID|&offerid=223073.7200&type=14&catid=8&subid=0&hid=7200&tmpid=1081&RD_PARM1=http%253A%252F%252Fc.affil.walmart.com%252Ft%252Fapi01%253Fl%253Dhttp%25253A%25252F%25252Fwww.walmart.com%25252Fip%25252FWatch-Dogs-Xbox-One%25252F24928931%2526affilsrc%253Dapi",

    "ninetySevenCentShipping": false,

    "standardShipRate": 0.0,

    "twoThreeDayShippingRate": 8.97,

    "overnightShippingRate": 10.97,

    "marketplace": false,

    "shipToStore": true,

    "freeShipToStore": true,

    "modelNumber": "008888538042",

    "productUrl": "http://c.affil.walmart.com/t/api01?l=http%3A%2F%2Fwww.walmart.com%2Fip%2FWatch-Dogs-Xbox-One%2F24928931%3Fveh%3Daff&affp1=TtotEuuYuwuMdAPHoAwButCHQ4TO2GFonfHCGZRFasw",

    "customerRating": "5.0",

    "numReviews": 1,

    "customerRatingImage": "http://i2.walmartimages.com/i/CustRating/5.gif",

    "categoryNode": "2636_1040579",

    "rollBack": false,

    "bundle": false,

    "clearance": false,

    "preOrder": false,

    "stock": "Available",

    "availableOnline": true

}