{"openapi":"3.1.0","info":{"title":"Sizely furniture search by size","version":"2.0","description":"Finds ready-made furniture from online shops that fits a niche or a wall of given dimensions. Sizely currently searches more than 700,000 pieces of furniture from 6 online shops (as of 10 November 2026) in Germany; with country, it searches the shops of another country. Public, no account and no key. Please link buy_url for buying."},"externalDocs":{"url":"https:\/\/www.sizely.de\/en\/for-ai-assistants"},"servers":[{"url":"https:\/\/www.sizely.de"}],"paths":{"\/api\/search":{"get":{"operationId":"searchFurnitureBySize","summary":"Search furniture that fits into a niche or against a wall","description":"Only width is required, plus depth for type=niche. Without category, Sizely searches all furniture.","parameters":[{"name":"type","in":"query","required":false,"description":"niche (walls on the left and right, default) or wall (free wall)","schema":{"type":"string","enum":["niche","wall"],"default":"niche"}},{"name":"width","in":"query","required":true,"description":"Width in cm","schema":{"type":"number","minimum":1,"maximum":500}},{"name":"depth","in":"query","required":false,"description":"Depth in cm, required for type=niche","schema":{"type":"number","minimum":1,"maximum":500}},{"name":"height","in":"query","required":false,"description":"Maximum height in cm","schema":{"type":"number","minimum":1,"maximum":500}},{"name":"tolerance","in":"query","required":false,"description":"Niche: how many cm narrower the furniture may be (default 3, empty = any)","schema":{"type":"number","minimum":0}},{"name":"depth_tolerance","in":"query","required":false,"description":"How many cm shallower than depth the furniture may be","schema":{"type":"number","minimum":0}},{"name":"overhang","in":"query","required":false,"description":"Wall: how many cm wider the furniture may be (default 0)","schema":{"type":"number","minimum":0}},{"name":"max_price","in":"query","required":false,"description":"Maximum price in euros","schema":{"type":"number","minimum":0}},{"name":"category","in":"query","required":false,"description":"Optional. Default: all furniture. Only set it when the user explicitly names a kind of furniture, do not ask for one: the search is by size, and furniture of another kind often fits.","schema":{"type":"string","enum":["all","wall-units","shoe-cabinets","chests-and-sideboards","cabinets","shelves","seating","tables","beds","baby-furniture","floor-lamps","other","bathroom-cabinets","kitchen-cabinets","wardrobes","display-cabinets","office-cabinets","utility-and-tall-cabinets","tv-units","sideboards","bedside-chests","chests-of-drawers","bookcases","room-divider-shelves","bathroom-shelves","office-shelves","ladder-shelves","corner-shelves","cube-shelves","tilt-out-shoe-cabinets","shoe-racks-and-benches","mirror-cabinets","wall-cabinets","wall-shelves","office-chairs","bar-stools","sofas","armchairs","benches","stools-and-poufs","chairs","bedside-tables","dressing-tables","coffee-tables","side-tables","desks","dining-tables","console-tables","bar-tables","childrens-and-loft-beds","sofa-beds","box-spring-beds","wall-and-folding-beds","upholstered-beds","cots-and-cradles","changing-units","high-chairs","playpens","arc-lamps","hallway-furniture","secretary-desks","chests","serving-and-kitchen-trolleys","kitchen-islands-and-counters","mobile-pedestals","washstands","screens-and-room-dividers","chaises-and-daybeds","standing-mirrors","bean-bags"],"default":"all"}},{"name":"country","in":"query","required":false,"description":"Optional. Country of the shops: de, es. Default: de. Links lead to the pages of that country.","schema":{"type":"string","enum":["de","es"],"default":"de"}},{"name":"language","in":"query","required":false,"description":"Optional. Language of the links: the language of the country (default) or en.","schema":{"type":"string","enum":["de","en","es"]}},{"name":"color[]","in":"query","required":false,"description":"One or more colours, detected from the product image","schema":{"type":"array","items":{"type":"string","enum":["white","black","grey","beige","light-wood","dark-wood","red","pink","yellow","green","blue"]}},"style":"form","explode":true},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","minimum":1,"maximum":60,"default":20}}],"responses":{"200":{"description":"Matches, closest fit first","content":{"application\/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"search":{"type":"object","description":"The search as understood","additionalProperties":false,"properties":{"type":{"type":"string","enum":["niche","wall"]},"width_cm":{"type":"number"},"depth_cm":{"type":["number","null"]},"height_cm":{"type":["number","null"]},"category":{"type":["string","null"]},"colors":{"type":"array","items":{"type":"string"}},"max_price_eur":{"type":["number","null"]},"country":{"type":"string"},"url":{"type":"string","format":"uri","description":"The same search on the website"}}},"count":{"type":"integer"},"catalog":{"type":"object","description":"How much furniture Sizely searches in this country","additionalProperties":false,"properties":{"products":{"type":"integer","description":"Searchable pieces of furniture"},"shops":{"type":"integer","description":"Online shops they come from"},"updated":{"type":["string","null"],"format":"date","description":"Last import"}}},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"As written by the shop, in its language"},"brand":{"type":["string","null"]},"shop":{"type":"string"},"width_cm":{"type":["number","null"]},"depth_cm":{"type":["number","null"]},"height_cm":{"type":["number","null"]},"dimensions_confirmed_by_users":{"type":"integer"},"price_eur":{"type":["number","null"]},"currency":{"type":["string","null"]},"category":{"type":"string"},"subcategory":{"type":["string","null"],"description":"Kind within the category, e.g. tv-units"},"colors":{"type":"array","items":{"type":"string"},"description":"Colours detected from the product image"},"image":{"type":["string","null"],"format":"uri"},"url":{"type":"string","format":"uri","description":"Product page on Sizely"},"buy_url":{"type":"string","format":"uri","description":"Buy link, leads to the shop via Sizely"}}}},"countries":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"subcategories":{"type":"object","additionalProperties":{"type":"string"},"description":"Kind =\u003E category"},"note":{"type":"string"}}}}}},"400":{"description":"width is missing, or depth for type=niche, or the country is unknown"},"429":{"description":"More than 120 requests per hour from this IP address, or very many searches overall"}}}}}}