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. To 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.
Note: We recommend that you set up a process to monitor and ensure that your items get pushed to Walmart.com. |
Setup Item Variants with APIs

The Get item count by groups API allows you quickly view the item variant group IDs and counts of variant groups. With the data from this API, you can use it to filter Get All Items API, Get and item API, and Catalog Search API.
- – Catalog Search: Add the additional query below to search for the variant Group ID with the Catalog Search API.
"query": {
"field": "variantGroupId",
"value": "string"
}
To learn about how to group items, see Variant Setup.
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 October 1, 2022 . 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 SellerHelp Walmart. 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.