Utilities

The Utility APIs allow you to search for all Walmart item departments, all categories within a department, or retrieve the taxonomy of categories per Feed type.

Utility APIs

• GET All Departments API – Search for all Walmart item departments and department IDs. Use this for Insights about item best sellers.
• GET All Categories API – Search for all Walmart item categories within a department. Use this to fine-tune your best seller searches within a department.
• GET Taxonomy by spec API – Get the item category and sub-category taxonomy for any given Item spec you specify by feedType and version. Use this API to determine which category to best position your product. You can also find similar products under the same subcategory to improve your product organization and placement on Walmart.com.

Get Insights about top-trending Items

To use the Department and Category APIs for insights, see Get all top trending items.

Get Insights about why items go unpublished

To find out the reasons why items go unpublished, see Get unpublished item insights.

To better position your items within categories, use the Taxonomy by spec 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, see Item spec v4.

Get all item categories by item spec version

To get the item category taxonomy for the item spec you are using, call the Taxonomy by spec API.

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 see an entire payload response sample, see Taxonomy by spec in the API Reference.