Get & use JOOR categories

Retrieve and identify categories to use for product data

What are Categories?

Categories on JOOR define a grouping for similar products. Each product can have none or many categories. JOOR has defined its own category taxonomy to help organize products across JOOR's entire client base, which in the end drives product/brand discovery on the JOOR marketplace.

JOOR Categories taxonomy is fairly static; however, JOOR adds new category branches to include new types of business that were previously not supported on JOOR or to support special events.

JOOR Categories taxonomy has three levels

  • department - a root category, ex. Home, Women, Accessories
  • parent_name - a parent category, ex. Denim, Apparel, General Home
  • name - category, ex. Cargo, Boots, Stationery

Each category branch such as Home > Accessories > Fragrances is identified by an id, which is used in the product creation and update requests

How to get and use Categories

To get the most recent list of categories use the GET /traits endpoint.

{
            "id": "2405",
            "name": "Stationery",
            "parent_name": "General Home",
            "department": "HOME"
        },
        {
            "id": "2406",
            "name": "Fragances",
            "parent_name": "Accessories",
            "department": "HOME"
        },
        {
            "id": "2407",
            "name": "Jumpsuits",
            "parent_name": "Apparel",
            "department": "BABY_GIRLS"
        },
        {
            "id": "2408",
            "name": "Skirts",
            "parent_name": "Apparel",
            "department": "BABY_GIRLS"
        }