# IKEA Box Finder > Measure a space, get the IKEA containers that fit it, ranked by how much of > the space they use. Answers come from a local mirror of IKEA's GB catalogue, > so no request reaches IKEA and this service can be called freely. Read only. No key, no rate limit. Metric throughout: centimetres and litres. Machine-readable schema: /openapi.json · browsable docs: /docs The mirror holds 432 products (118 with usable dimensions), last updated 2026-11-14T18:24:09+00:00. It refreshes weekly. ## Endpoints GET /api/fit?width=&depth=&height= Every container that fits, best use of the space first. Required: width, depth, height in cm. Optional: clearance (default 0.5 cm, subtracted once per axis), tipping (default false), limit (default 50), count_penalty (default 0.2), measure (floor, the default, or volume), and source (default all — see "Whose containers" below). Each result gives count (how many fit), grid (along width, depth, height), coverage (0..1 of the floor covered), utilisation (0..1 of the volume filled), as_placed_cm (the box as oriented), price (one box) and total_price (what the answer costs). Where a product is sold in a pack, pack_quantity, pack_price and packs_needed say so, and total_price buys whole packs. GET /api/suggest?width=&depth=&height= The best few containers in each way of packing, since one big box and nine small ones are different recommendations. Same parameters, plus top (default 3). Axes are named for the cavity: x is width, y is depth, z is height. grid is the count along each. Modes: single One box only x Tiled across the width y Tiled back into the depth z Stacked up the height xy Tiled across the floor (width × depth) yz Tiled depth × height xz Tiled width × height xyz Packed in all three directions GET /api/options?width=&depth=&height= The best answers for each preference, which is usually the question a person is really asking. The baseline is one layer of upright boxes at least half the usable height. Groups: best (the baseline), count_1_2, count_3_4, count_5_6, count_7_plus (the baseline by how many boxes fill the space), stacked (two layers or more, ranked by volume) and shallow (trays and low boxes under shallow_below_cm). Same parameters as fit, plus top (default 2) answers per group. GET /api/products?q=&show=&source=&raw= Every product in the mirror: what IKEA published, the dimensions we resolved from it, and our stacking judgement with its reason. q matches name, type, colour or item number. show is all (default), fittable, incomplete, or accessories. raw=true adds IKEA's search record verbatim. GET /api/products/{item_no} One product in full. GET /img/{item_no} Its thumbnail, served from the mirror. GET /health Mirror status; 503 until it holds dimensions. ## Whose containers IKEA is crawled weekly. The others are standardised ranges that change so rarely that they are checked-in files rather than crawls, which is also why most carry no price: they are sold by many shops rather than one. euro Euro container (RAKO) — 9 sizes https://www.utzgroup.co.uk/stackingcontainer/ Standard footprints: 300x200, 400x300, 600x400, 800x600 mm. Lids are sold separately. ikea IKEA — 325 sizes https://www.ikea.com/gb/en/ crawled weekly; prices in GBP muji MUJI — 55 sizes https://www.muji.co.uk/home/storage Prices are MUJI UK, in GBP, at the date checked. Sizes are external unless an entry notes an interior. really-useful Really Useful Products — 43 sizes https://www.reallyusefulproducts.co.uk/uk/html/boxdetails.php Sold by Ryman, Staples, Argos, Amazon and others; prices vary by retailer, so none are recorded here. Pass source= to /api/fit, /api/suggest or /api/products to hear about one maker only; the default is all of them. interior_cm is the inside of a box, which IKEA does not publish at all and most of the catalogues do — it is the only way to answer "will this object fit INSIDE" rather than "does this box fit the gap". ## Worked example curl 'https://ikea.ryi.ai/api/suggest?width=100&depth=60&height=40' curl 'https://ikea.ryi.ai/api/fit?width=33&depth=39&height=33&limit=5' curl 'https://ikea.ryi.ai/api/products?q=samla&show=fittable' A KALLAX cube is about 33 x 39 x 33 cm. ## What the answers mean, and what they do not Dimensions are EXTERNAL. IKEA publishes no interior measurements for boxes, so "which containers fit this 40x30 cm gap" is answered exactly, while "will my object fit inside the box" can only be approached through volume_l. Ranking is by floor covered unless measure=volume: how much of the usable floor the boxes' footprints cover (coverage). Boxes in a cupboard are usually left open, and then what is in them can rise to the shelf above, so a box half the cavity's height still makes the whole column above it usable. Stacking adds no floor, so this measure never rewards it: with free packing the boxes stay in one layer, and among boxes covering the same floor the taller ones rank first. measure=volume ranks by utilisation instead: how many fit at once, times their volume, over the usable cavity volume, which does reward stacking. Both figures are always returned. count_penalty discounts answers made of many small boxes (score = coverage or utilisation / count ** penalty); raise it toward 1 to be shown fewer, larger containers. Boxes may be turned 90 degrees on the spot. They are laid on their side only when tipping=true, and then only products that still work that way. Stacking and lying on their side are OUR judgement, not IKEA data: IKEA has no such field. Where IKEA's own product text says a thing stacks, that decides it and stackable_why quotes the sentence; otherwise the product type decides (lidded boxes stack, open boxes, baskets and soft fabric cases do not). A product that does not stack is never stacked in an answer: it is kept to one layer and the result says stack_limited. Prices are IKEA GB, in GBP, as of the last refresh, so up to a week old. price is always for ONE box. Some products are sold only in packs — GLIS is £2 for three — and IKEA prices the listing, so that price is divided by the pack quantity it publishes. total_price goes the other way and charges for whole packs, because you cannot buy two thirds of one: seven GLIS boxes is three packs, £6, with two boxes spare. pack_quantity, pack_price and packs_needed are on every result, and are 1 / null / null for the ordinary case of a listing that is one box. Accessories (lids, clip locks) are excluded from answers: they have real dimensions but are not things you put things in. They are still listed under /api/products?show=accessories. Where a product's data is wrong, the fault is usually IKEA's search string: it is lossy, and VESSLA reports "39x39 cm" for a product that is 39x39x28. We resolve dimensions from the typed measurement list on the product page instead, which /api/products returns so you can check the parse yourself. ## Source https://github.com/aeone/ikea-box-finder__RB8E-aortal