Taxonomy API

Taxonomy API exposes the category taxonomy used by walmart.com to categorize items. It describes three levels - Departments, Categories and Sub-categories as available on Walmart.com. It is possible to specify the exact category as a parameter when using any of the API's below:

  • Search
  • Data feeds 
  • Special feeds - [Pre-order, Best sellers, Rollbacks, Clearance and Special buys]

For example, Search API can be restricted to search within a category by supplying id as per the taxonomy. Similarly, Feed API can be used to download category specific feeds by specifying a category id.

Example Query

http://api.walmartlabs.com/v1/taxonomy?apiKey={apiKey}&format=xml

Formats

xml, json

Query Parameters

Param Name Description Required/Optional
apiKey Your API access key. Required
format Format of the response, allowed values are [xml, json]. Default response returned is json.

Optional

Response

 Consists of a list of top level categories.

Field Name Description Always present
id Category id for this category. These values are used as an input parameter to other APIs. Yes
name Name for this category as specified on Walmart.com

Yes

children List of categories that have the current category as a parent in the taxonomy. No

Sample Response

{

   "categories": [

      {

         "id": "5438",

         "name": "Apparel",

         "children": [

            {

               "id": "5438_426265",

               "name": "Accessories"

            },

            {

               "id": "5438_1104812",

               "name": "Americana"

            },

            {

               "id": "5438_1043628",

               "name": "Baby Clothing"

            },

            {

               "id": "5438_1045799",

               "name": "Bags"

            },

            {

               "id": "5438_133199",

               "name": "Boys"

            },

            {

               "id": "5438_133202",

               "name": "Girls"

            },

            {

               "id": "5438_1078024",

               "name": "Intimates"

            },

            {

               "id": "5438_133201",

               "name": "Juniors"

            }

         ]

      }

   ]

}