IKEA · JSON Structure

Ikea Product Catalog Store Structure

Store details

Type: object Properties: 18 Required: 15
RetailHome FurnishingsConsumer ProductsOpensourceCommunityUnofficial APISmart Home

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

Properties

name lat lng address homeShoppingUnit openCloseDates hours displayName externalPickupPoint extras hideStore placeId storePageUrl treatAsStore displayNameAlternate weekStartDay id buClassification

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

JSON Structure

Raw ↑
{
  "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-store-structure.json",
  "name": "Store",
  "description": "Store details",
  "properties": {
    "name": {
      "type": "string",
      "description": "Store name",
      "example": "IKEA Berlin - Tempelhof"
    },
    "lat": {
      "type": "string",
      "description": "Store latitude",
      "example": "52.46958147"
    },
    "lng": {
      "type": "string",
      "description": "Store longitude",
      "example": "13.36625688"
    },
    "address": {
      "type": "object",
      "description": "Store Address",
      "required": [
        "street",
        "zipCode",
        "city",
        "timezone",
        "displayAddress"
      ],
      "properties": {
        "street": {
          "type": "string",
          "description": "Street",
          "example": "Sachsendamm 47"
        },
        "zipCode": {
          "type": "string",
          "description": "ZIP code / Postal code",
          "example": "10829"
        },
        "city": {
          "type": "string",
          "description": "City",
          "example": "Berlin,Tempelhof"
        },
        "timezone": {
          "type": "string",
          "description": "Timezone",
          "example": "Europe/Berlin"
        },
        "stateProvinceCode": {
          "type": "string",
          "description": "Stage and State/province code",
          "example": "DEBE"
        },
        "displayAddress": {
          "type": "string",
          "description": "Display Address",
          "example": "Sachsendamm 47, Berlin,Tempelhof"
        }
      }
    },
    "homeShoppingUnit": {
      "type": "boolean",
      "example": false
    },
    "openCloseDates": {
      "type": "object",
      "properties": {
        "openingDate": {
          "type": "datetime",
          "example": "2003-11-27T00:00:00Z"
        }
      }
    },
    "hours": {
      "type": "object",
      "description": "Various unit opening hours",
      "additionalProperties": {
        "description": "Opening hour schedule name observed values:\n  * `normal`\n  * `exceptions`\n  * `restaurant`\n  * `bistro`\n  * `cafe`\n  * `clickncollect`\n  * `swedishFoodMarket`\n  * `smaland`\n  * `closed`\n",
        "type": "array",
        "items": {
          "type": "object",
          "description": "Opening hours for unit",
          "properties": {
            "close": {
              "type": "time",
              "description": "Closing time in HH:mm format",
              "example": "17:00"
            },
            "day": {
              "type": "string",
              "description": "Day of the week (abbreviated, uppercase)",
              "enum": [
                "MON",
                "TUE",
                "WED",
                "THU",
                "FRI",
                "SAT",
                "SUN"
              ],
              "example": "MON"
            },
            "open": {
              "type": "time",
              "description": "Opening time in HH:mm format",
              "example": "09:00"
            }
          }
        }
      },
      "example": {
        "normal": [
          {
            "close": "20:00",
            "day": "MON",
            "open": "10:00"
          },
          {
            "close": "20:00",
            "day": "THU",
            "open": "10:00"
          }
        ]
      }
    },
    "displayName": {
      "type": "string",
      "description": "Store Display Name",
      "example": "Berlin-Tempelhof"
    },
    "externalPickupPoint": {
      "type": "object",
      "example": {
        "hours": []
      }
    },
    "extras": {
      "type": "object",
      "example": {
        "normal": {
          "body": "From September 1, 2025, our store will be open Monday through Saturday from 10:00 a.m. to 8:00 p.m.",
          "heading": "New opening hours from September 1, 2025.."
        }
      }
    },
    "hideStore": {
      "type": "boolean",
      "description": "Show or Hide the store",
      "example": false
    },
    "placeId": {
      "type": "string",
      "description": "Place ID",
      "example": "ChIJw7UyJQVQqEcRzw0vmZtAbTg"
    },
    "storePageUrl": {
      "type": "uri",
      "description": "Store Page URL",
      "example": "https://www.ikea.com/de/de/stores/berlin-tempelhof/"
    },
    "treatAsStore": {
      "type": "boolean",
      "example": false
    },
    "displayNameAlternate": {
      "type": "string",
      "description": "Alternate Store Display Name",
      "example": "IKEA Berlin-Tempelhof"
    },
    "weekStartDay": {
      "type": "string",
      "example": "MON"
    },
    "id": {
      "type": "string",
      "description": "Store ID",
      "example": "421"
    },
    "buClassification": {
      "type": "object",
      "required": [
        "code",
        "name"
      ],
      "properties": {
        "code": {
          "type": "string",
          "example": "STORE"
        },
        "name": {
          "type": "string",
          "example": "IKEA STORE"
        }
      }
    }
  },
  "required": [
    "name",
    "lat",
    "lng",
    "address",
    "homeShoppingUnit",
    "openCloseDates",
    "hours",
    "displayName",
    "extras",
    "hideStore",
    "treatAsStore",
    "displayNameAlternate",
    "weekStartDay",
    "id",
    "buClassification"
  ]
}