Item Management API overview

The Marketplace Item Management API guide provides comprehensive instructions, best practices, and recommendations for creating and maintaining your item listings on Walmart.com.

The item is the entry point and the most important building block for sellers to maintain a successful catalog on Walmart.com. Item management is the process of adding detailed information of the item you're listing on Walmart.com. Item management allows you to provide detailed product descriptions, pricing strategies, inventory quantities, or item restrictions. The Item Management API requests enable sellers to set up and manage items. Items must be published for customers to see and purchase on Walmart.com.

The workflows below provide a high-level overview of the Item Management APIs offered by Walmart. The diagrams guide you through a recommended workflow for complete item setup and maintenance. Additionally, they illustrate the APIs needed to successfully create and update items, manage inventory, and gain insights into your item's performance.

1. Understanding item setup requirements using Walmart Taxonomy and Get Spec APIs
   • Use the GET Taxonomy API request to obtain Walmart’s hierarchy product types, product type groups, and categories. This information is essential for identifying the correct product type for your item listing.
   • Use the Get Spec API to obtain the item setup requirements for up to 20 product types of your choice.
   • You can also choose to download the Item Product Type Spec Schema, which will contain the requirements for all Walmart’s product type specs.
     1a. Use API requests detailed in the Get Insights on My Existing Items section to get actionable information on your existing items in the catalog.
2. Creating items on Walmart.com
   • The primary way to list an item on Walmart.com is to use the Offer Setup by Match (OSBM) flow to quickly create an offer for a pre-existing item in the Walmart catalog.
   • Use the Full Item Setup workflow to create a new listing when Walmart is currently not selling your item. Full Item Setup requires you to provide a detailed set of attributes for your product.
     NOTE: Walmart requires pre-authorization for certain programs such as, Restored, Pre-Owned, and Refurbished. Learn more about Walmart Restored and Pre-Owned programs.
     2a. Use the Bulk Item Setup API request and MP_MAINTENANCE feed type to submit item maintenance. Learn more about Update my existing items.
3. Monitor my item status
   • Use the GET All Feed Status and GET Feed Item Status API requests to track your submission.
     3a. For WFS only: While submitting a WFS Item Create or WFS Convert, one of the errors you may face is items being on a compliance hold. This means Walmart has identified the item as hazardous and flags the item for compliance review. Use the POST Hazmat Items On-Hold API request to see items that are on hold for hazmat compliance and to review the errors and understand how to correct them for further assessment.
4. Get Insights and Update my existing items
   • Walmart offers a variety of APIs to get insights into your items once you have completed the item setup. Learn more about the Insight APIs that Walmart offers.
5. Post Item Management
   • After completing item setup Walmart offers a variety of additional resources to manage your post item setup life cycle.