IKEA · JSON Structure

Ikea Product Catalog Category Structure

Category details

Type: object Properties: 5 Required: 3

RetailHome FurnishingsConsumer ProductsOpensourceCommunityUnofficial APISmart Home

Category is a JSON Structure definition published by IKEA, describing 5 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id name url im subs

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "type": "object",
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ikea/refs/heads/main/json-structure/ikea-product-catalog-category-structure.json",
  "name": "Category",
  "description": "Category details",
  "properties": {
    "id": {
      "type": "string",
      "description": "Category identifier (UUID, code like 'st001', or numeric ID)",
      "example": "st001",
      "examples": [
        "st001",
        "4a552556-db67-4fab-afb0-11433eda6784"
      ]
    },
    "name": {
      "type": "string",
      "description": "Category display name",
      "example": "Storage furniture"
    },
    "url": {
      "type": "string",
      "description": "Relative path to the category",
      "example": "/gb/en/cat/storage-furniture-st001/"
    },
    "im": {
      "type": "uri",
      "description": "Category image URL",
      "example": "https://www.ikea.com/images/4e/83/4e83f2c50f6d1cf0e3d90e78662de08b.png?f=sg"
    },
    "subs": {
      "type": "array",
      "description": "Array of Category objects (recursive).\nEach subcategory has the same structure as this schema.\nMaximum depth observed: 4 levels.\n",
      "items": {
        "type": "object",
        "description": "Category details",
        "required": [
          "id",
          "name",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Category identifier (UUID, code like 'st001', or numeric ID)",
            "example": "st001",
            "examples": [
              "st001",
              "4a552556-db67-4fab-afb0-11433eda6784"
            ]
          },
          "name": {
            "type": "string",
            "description": "Category display name",
            "example": "Storage furniture"
          },
          "url": {
            "type": "string",
            "description": "Relative path to the category",
            "example": "/gb/en/cat/storage-furniture-st001/"
          },
          "im": {
            "type": "uri",
            "description": "Category image URL",
            "example": "https://www.ikea.com/images/4e/83/4e83f2c50f6d1cf0e3d90e78662de08b.png?f=sg"
          },
          "subs": {
            "type": "array",
            "description": "Array of Category objects (recursive).\nEach subcategory has the same structure as this schema.\nMaximum depth observed: 4 levels.\n",
            "items": {
              "type": "object",
              "description": "Category details",
              "required": [
                "id",
                "name",
                "url"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Category identifier (UUID, code like 'st001', or numeric ID)",
                  "example": "st001",
                  "examples": [
                    "st001",
                    "4a552556-db67-4fab-afb0-11433eda6784"
                  ]
                },
                "name": {
                  "type": "string",
                  "description": "Category display name",
                  "example": "Storage furniture"
                },
                "url": {
                  "type": "string",
                  "description": "Relative path to the category",
                  "example": "/gb/en/cat/storage-furniture-st001/"
                },
                "im": {
                  "type": "uri",
                  "description": "Category image URL",
                  "example": "https://www.ikea.com/images/4e/83/4e83f2c50f6d1cf0e3d90e78662de08b.png?f=sg"
                },
                "subs": {
                  "type": "array",
                  "description": "Array of Category objects (recursive).\nEach subcategory has the same structure as this schema.\nMaximum depth observed: 4 levels.\n",
                  "items": {
                    "$ref": "#/components/schemas/Category"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "id",
    "name",
    "url"
  ]
}