API Reference
My Account

Taxonomy

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

The taxonomy API exposes the Product Type (PT) taxonomy that Walmart uses to classify items. This API provides the user with all Product Types (PTs) in their respective Product Type Groups (PTGs). The Product Type Groups (PTGs) are then organized into categories. To get the ProductType taxonomy, pass the version attribute in the query params as instructed below.

This API also supports the older taxonomy which was Category-based. To continue to use that, do not pass the "version" attribute.


Market availability: US only

Query Params
string
Defaults to 4.1

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

US supports both 4.x and 5.x version

Market availability: US only

string
enum

The type of feed, which specifies the nature of the update.

OMNI_WFS supports US only

Market availability: US only

Allowed:
Headers
string
required

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

Market availability: Global

string

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

Market availability: Global

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.

Market availability: Global

string
required

Specifies the name of the Walmart service being called.

Market availability: Global

string
enum
required

The target market of the API call.

Market availability: Global

Allowed:
string
enum
required

The version of the global API used.

Market availability: Global

Allowed:
Responses

Updated 7 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 7 days ago