The Utilities API allows you to search for all Walmart item departments, all categories within a department, and retrieve the taxonomy of categories per Feed type.
You can use the Taxonomy API to get all the available categories and subcategories from Walmart.
Use the returned categories to decide which category to position your product. You can also find similar products under the same subcategory to improve your product organization and placement on Walmart.com.
The Utilities API includes three separate options:
- Taxonomy API – Get the item category and sub-category taxonomy for any given Item spec you specify by feedType. Use this API to determine which category to position your product.
- All Departments API – Search for all Walmart item departments and department IDs. Use this for Insights about item best sellers.
- 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 item category taxonomy per Item spec
You can specify the feedType for the item spec you are using, and call the Taxonomy API to return the item category hierarchy for that feed. The response includes IDs and Names for all item categories and sub-categories.
Use Taxonomy API and specify the feed type depending on which Item spec you choose.
Pass the feedType and version as a query parameters when you call the taxonomy resource: https://marketplace.walmartapis.com/v3/utlities/taxonomy/
Specify the feedType that corresponds to the Item spec that you ingest your items with the Item setup process:
item?feedType=MP_ITEM&version=4.0item?feedType=MP_MAINTEINANCE&version=4.0item?feedType=MP_WFS_ITEM&version=4.0item?feedType=item&version=3.2
| NOTE: If you do not pass in a feedType, the response returns Item Spec v3.2 categories by default. |
Get Insights about top-trending Items
To use the Department and Category APIs for insights, see Get all top trending items.