Get item category taxonomy by spec version

To better position your items within categories, use the Taxonomy API to view the category taxonomy available on Walmart.com for a specific feedType and spec version.

You can specify an item spec version and get the category hierarchy for that particular schema. Use the returned categories to decide which category to position your product.

As a seller, you can decide where to place your products within Walmart categories for each item spec available. These are the latest versions:

• Walmart Item spec – feedType=MP_ITEM, version 4.2
• Walmart and WFS item spec – feedType=MP_WFS_ITEM, version 4.1
• Item update spec – feedType=MP_MAINTENANCE, version 4.1

The response provides the item taxonomy of categories and sub-categories in the hierarchy for the spec version you specified in the request.

The taxonomy API supports all versions of item feeds. To get more information about the latest individual item specs available, refer to Item spec versions.

Get all item categories by item spec version

To get the item category taxonomy for the item spec you are using, call the TaxonomyAPI.

Specify the feedType that corresponds to the Item spec that you ingest your items with the Item setup process:

• feedType=MP_ITEM&version=4.2
• feedType=MP_MAINTENANCE&version=4.1
• feedType=MP_WFS_ITEM&version=4.1

NOTE: If you do not pass in a feedType, the response returns Item Spec v3.2 categories by default.

The response includes IDs and Names for all item categories and sub-categories for that Item spec.

For example, to get all categories for MP_ITEM feedType version 4.0, call

/v3/utilities/taxonomy?feedType=MP_ITEM&version=4.2

Upon success, the response returns a list of Category Names and IDs. Here is a brief example with two entries:

{ “success”: “SUCCESS”, “payload”: [ { “categoryName”: “Animal Accessories”, “categoryId”: “animal_accessories” }, { “categoryName”: “Animal Food”, “categoryId”: “animal_food” }, ] }

To view an entire payload response sample, refer to Taxonomy in the API Reference.