Item Spec 5 API – Walmart Developer Portal (2024)

Walmart has launched new and updated requests in the Item Management API! Item Spec 5 now has Product Type Groups and Product Types aimed to improve content quality during item setup and maintenance through granular Product Type data models. This will create consistency between specs, style guides and content quality scoring.

The Key Benefits of this new release for Item Spec:

• Focused attributes that drive item discoverability (Search, Shelving, Facets)
• New and Enhanced API Experiences (Taxonomy API)

These new and updated requests include:

• Walmart Product Taxonomy: Lets sellers understand Walmart’s product taxonomy. The multiple levels for organization, this functionality provides sellers the ability to find and select the product type that they will use to set up or maintain their items.
• Item Setup and Maintenance by Product Type: Enables sellers to set up and maintain items by using the items’ product types. This intends to improve the content quality score.

High Level Overview – Item Setup Steps

Item Management Requests Available

Outlined below are details of the new APIs that are part of Item Spec 5.

Product Taxonomy Overview

Walmart’s product taxonomy is the system Walmart uses toorganize, classify, and group like items.

The taxonomy now extends to the product type level. Basedon the product type, each item will have distinct required attributes andvalues. It is critical that sellers understand and use the establishedtaxonomy, as sellers must define the product type of the item they are managing(setting up or maintaining).

What is Walmart’s Product Taxonomy Structure?

Walmart’s product taxonomy is a method of product classification arranged to aid retrieval (search and filter) and help Walmart customers find items on Walmart.com.

Walmart’s product taxonomy is segmented into three distinct classifications, listed in order from broadest to most refined:

• Category
• ProductType Group
• Product Type

One category contains multiple product type groups, and one product type group contains multiple product types. Drilling down to the product type name allows sellers to understand which product types are available, their definitions, and what to include in item setup and maintenance by product type specs. You will be able to Filter by Type (Product Type Group; Product Type)

How is Product Taxonomy Used in Item Setup and Maintenance?

Sellers must always indicate the item’s product type when setting up an item or maintaining item content. As such, the list retrieved from the GET Product Taxonomy call allows sellers to understand the product types available for use and their meaning. The different relationship levels allow for sellers to group and organize the product types to navigate the taxonomy.

API Details and Sample Response

URL: https://marketplace.walmartapis.com/v3/items/taxonomy?version=5.0

SAMPLE RESPONSE:

{ "itemTaxonomy": [ { "category": "Media", "description": "Media", "productTypeGroup": [ { "productTypeGroupName": "Music", "description": "Music", "productType": [ { "productTypeName": "Music", "description": "Music" } ], "department": [ { "departmentName": "MEDIA AND GAMING", "departmentNumber": "5" }, { "departmentName": "LOCAL SHOPS AND SOUVENIRS", "departmentNumber": "60" }, { "departmentName": "IMPULSE MERCHANDISE", "departmentNumber": "82" } ] }, { "productTypeGroupName": "Video Game Software", "description": "Video Game Software", "productType": [ { "productTypeName": "Video Games", "description": "Interactive software that is used for entertainment, role playing and simulation.\t\t" } ], "department": [ { "departmentName": "MEDIA AND GAMING", "departmentNumber": "5" }, { "departmentName": "IMPULSE MERCHANDISE", "departmentNumber": "82" }, { "departmentName": "SUB-DEPT: DEPT #05", "departmentNumber": "55" } ] }, { "productTypeGroupName": "Movies & TV Shows", "description": "Movies & TV Shows", "productType": [ { "productTypeName": "Movies", "description": "A story or event recorded by a camera as a set of moving images and shown in a theater or on television; a motion picture." }, { "productTypeName": "TV Shows", "description": "A program broadcast by television." } ], "department": [ { "departmentName": "MEDIA AND GAMING", "departmentNumber": "5" }, { "departmentName": "LOCAL SHOPS AND SOUVENIRS", "departmentNumber": "60" }, { "departmentName": "IMPULSE MERCHANDISE", "departmentNumber": "82" } ] } ] } ], "status": "SUCCESS"}

POST Item Setup and Maintenance by Product Type: Overview & Capabilities

The POST Item Setup and Maintenance by Product Type calls are all performed through Walmart’s standard bulk async feed files. For more on bulk async feed files, see the Feeds guide. [link to here: https://developer.walmart.com/doc/us/us-mp/us-mp-feeds/ ]

There is no change in the feedType that is going to be sent when compared to the 4.8 spec version. (MP_ITEM, MP_MAINTENANCE, MP_WFS_ITEM, OMNI_WFS). The new Spec 5 version to use however would be the ones you download from the links in the table below.

Select the needed JSON schema, dependent on if the seller is creating new items for Walmart (item setup by product type) or maintaining currently set up items (item maintenance by product type). Feed files or specs will also vary depending on the fulfillment type of MP (Seller fulfilled) or WFS (Walmart fulfilled). Each feed file contains all relevant attributes aligned to the standards displayed in the Walmart item style guides. [link to here: ]

API Details and Sample Response

URL: https://marketplace.walmartapis.com/v3/feeds

Item PT Specs