Guides
My Account

Item management API overview

Suggest Edits

You can set up your items for sale on Walmart.com with the Item Management API. Walmart classifies a product with its corresponding listing price information as an “item.” To make your items available for customers to purchase on Walmart.com, the items must have their prices adjusted (optional), have inventory assigned, submitted, and published.

📘

Note: You need to complete seller registration, and get your API Key (Client Secret and Client ID) to start item integration. To access your API Key, go to My Account. Select Login Type, choose Marketplace to get to API Keys.

Submit and publish processes

As a seller, you trigger the submit and publish processes in a single action. Add or change inventory requires a separate action.

Item submit process will parse and classify an item. This process typically takes a few hours. Item publish process requires Walmart systems to process items that have all necessary attributes confirmed. This typically takes a few hours.

About item spec versions

The Marketplace APIs provides one item spec version: item spec v4.X. The legacy version v3.2 does not provide the enhanced setup workflow, and will be deprecated on March 31, 2024 . We recommend that you use the new optimized Item spec v4.X and new feed types when you do your initial setup with the Bulk item setup API. To learn more about item setup strategies and concepts, see Walmart Marketplace Learn. To learn how to set up items in bulk, see Add Items in Bulk.

Optimized Item setup and maintenance with Item Spec v4.X

Item spec v4.x optimizes the Walmart Global Data Model with new and improved existing attributes, and a faster, more efficient item setup and maintenance process. Improvements include:

  • Better data definitions, modern attribute names, and precise attribute organization.
  • Increased buyer search discoverability for your items.
  • Increased variant grouping options that organize products in site navigation for better buyer visibility.
  • New product and compliance attributes.
  • Single setup process with one spec for combined Marketplace and WFS items.
  • Automated product tax code assignment.
  • Ability to set Sales restrictions for WFS-eligible items by state or zip code due to reasons: Commercial, or Illegal for sale.

Updated 7 days ago