API Reference
My Account

Taxonomy

get
https://marketplace.walmartapis.com/v3/items/taxonomy

The taxonomy API returns Walmart’s Product Type (PT) taxonomy, which classifies items into structured groups. Each Product Type belongs to a Product Type Group (PTG), and PTGs are organized into broader categories.

  • To retrieve the current PT taxonomy, include the `version` parameter.
  • To use the legacy category-based taxonomy, exclude the `version` parameter.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
Defaults to 4.1

This is an enum value. If ProductType hierarchy data is needed, the version attribute should be included in the request. The currently supported value for this attribute is 5.0.

string
enum

The type of feed specifies the nature of the update. Select an option from the drop-down list based on the type of update you need to perform. Example: MP_WFS_ITEM indicates the new WFS Item set up.

Allowed:
Headers
string
required

Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.

string

A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.

string
required

A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.

string
required

Specifies the name of the Walmart service being called.

Responses

Updated 3 days ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 days ago