{"service":"tailor.ai","base_url":"https://www.tailor.ai","countries":{"za":{"name":"South Africa","currency":"ZAR"},"us":{"name":"United States","currency":"USD"},"gb":{"name":"United Kingdom","currency":"GBP"}},"stores":{"hm":"H&M","co":"Cotton On","zara":"Zara","mango":"Mango"},"departments":["women","men","kids","baby"],"product_types":["tops","t-shirts","shirts-blouses","knitwear","hoodies-sweats","coats-jackets","suits-blazers","dresses","jumpsuits","skirts","jeans","trousers","shorts","activewear","swimwear","sleepwear","underwear","socks-tights","shoes","bags","accessories"],"colour_families":["black","white","grey","blue","green","red","pink","purple","yellow","orange","brown","beige","multi"],"endpoints":[{"method":"GET","path":"/api/search","url":"https://www.tailor.ai/api/search","summary":"Search products by text and/or photo, or browse by filters","description":"The main entry point. One garment per call — for an outfit, search once per piece.","parameters":[{"name":"q","in":"query","required":false,"type":"string","description":"Describe ONE garment the way a product page would: colour, cut, fabric, pattern, type, vibe. E.g. \"black high-waisted wide-leg linen trousers\". Omit to browse newest items matching the filters."},{"name":"image","in":"query","required":false,"type":"string","description":"image_id of a photo uploaded to tailor.ai (from /upload or POST /api/images). Finds products that look like it; add q to steer it (\"same but in red\")."},{"name":"image_url","in":"query","required":false,"type":"string","description":"Public URL of a photo to search by. It is stored and the response's links switch to its image id."},{"name":"weight","in":"query","required":false,"type":"number","default":0.5,"min":0,"max":1,"description":"With image + q: how much q steers vs. the photo. ~0.3 subtle, 0.5 balanced, ~0.7 big change."},{"name":"mode","in":"query","required":false,"type":"string","enum":["hybrid","semantic","lexical"],"default":"hybrid","description":"hybrid = meaning + keywords (default). semantic = look/meaning only. lexical = exact words only (names, '100% linen')."},{"name":"country","in":"query","required":false,"type":"string","enum":["za","us","gb"],"description":"The shop the person buys from: za = South Africa (prices in ZAR), us = United States (USD), gb = United Kingdom (GBP). Required for search; prices, sizes and delivery follow it."},{"name":"department","in":"query","required":false,"type":"string","enum":["women","men","kids","baby"],"description":"Who it is for — gender / age group. Strongly recommended: without it departments mix."},{"name":"store","in":"query","required":false,"type":"string","enum":["hm","co","zara","mango"],"description":"One retailer: hm = H&M, co = Cotton On, zara = Zara, mango = Mango. Omit for all."},{"name":"type","in":"query","required":false,"type":"string","enum":["tops","t-shirts","shirts-blouses","knitwear","hoodies-sweats","coats-jackets","suits-blazers","dresses","jumpsuits","skirts","jeans","trousers","shorts","activewear","swimwear","sleepwear","underwear","socks-tights","shoes","bags","accessories"],"description":"Hard filter on garment type. Optional — the query text usually suffices."},{"name":"colour","in":"query","required":false,"type":"string","enum":["black","white","grey","blue","green","red","pink","purple","yellow","orange","brown","beige","multi"],"description":"Hard filter on basic colour. For nuanced colours ('sage', 'rust') put them in q instead."},{"name":"brand","in":"query","required":false,"type":"string","description":"Exact brand, e.g. 'H&M', 'ZARA', 'MANGO', 'Cotton On Women', 'Factorie'. See /api/catalog."},{"name":"price_min","in":"query","required":false,"type":"number","min":0,"description":"Minimum price, in the country's currency (needs country)"},{"name":"price_max","in":"query","required":false,"type":"number","min":0,"description":"Maximum price (budget), in the country's currency (needs country)"},{"name":"on_sale","in":"query","required":false,"type":"boolean","description":"true → only discounted products"},{"name":"size","in":"query","required":false,"type":"string","description":"Only products listing this size as available, e.g. 'M', '10', '32'"},{"name":"limit","in":"query","required":false,"type":"integer","default":8,"min":1,"max":30,"description":"Products to return"},{"name":"exclude","in":"query","required":false,"type":"string","description":"Comma-separated product_ids to leave out (already shown or rejected)"}]},{"method":"GET","path":"/api/products/{product_id}/similar","url":"https://www.tailor.ai/api/products/{product_id}/similar","summary":"Products that look like a given product","description":"Visual neighbours. Stays in the product's country and department unless given.\nAdd price_max for cheaper look-alikes, store for the same look at another retailer.","parameters":[{"name":"product_id","in":"path","required":true,"type":"string","description":"product_id from a previous result, e.g. 'hm:1757988'"},{"name":"country","in":"query","required":false,"type":"string","enum":["za","us","gb"],"description":"The shop the person buys from: za = South Africa (prices in ZAR), us = United States (USD), gb = United Kingdom (GBP). Required for search; prices, sizes and delivery follow it."},{"name":"department","in":"query","required":false,"type":"string","enum":["women","men","kids","baby"],"description":"Who it is for — gender / age group. Strongly recommended: without it departments mix."},{"name":"store","in":"query","required":false,"type":"string","enum":["hm","co","zara","mango"],"description":"One retailer: hm = H&M, co = Cotton On, zara = Zara, mango = Mango. Omit for all."},{"name":"type","in":"query","required":false,"type":"string","enum":["tops","t-shirts","shirts-blouses","knitwear","hoodies-sweats","coats-jackets","suits-blazers","dresses","jumpsuits","skirts","jeans","trousers","shorts","activewear","swimwear","sleepwear","underwear","socks-tights","shoes","bags","accessories"],"description":"Hard filter on garment type. Optional — the query text usually suffices."},{"name":"colour","in":"query","required":false,"type":"string","enum":["black","white","grey","blue","green","red","pink","purple","yellow","orange","brown","beige","multi"],"description":"Hard filter on basic colour. For nuanced colours ('sage', 'rust') put them in q instead."},{"name":"brand","in":"query","required":false,"type":"string","description":"Exact brand, e.g. 'H&M', 'ZARA', 'MANGO', 'Cotton On Women', 'Factorie'. See /api/catalog."},{"name":"price_min","in":"query","required":false,"type":"number","min":0,"description":"Minimum price, in the country's currency (needs country)"},{"name":"price_max","in":"query","required":false,"type":"number","min":0,"description":"Maximum price (budget), in the country's currency (needs country)"},{"name":"on_sale","in":"query","required":false,"type":"boolean","description":"true → only discounted products"},{"name":"size","in":"query","required":false,"type":"string","description":"Only products listing this size as available, e.g. 'M', '10', '32'"},{"name":"limit","in":"query","required":false,"type":"integer","default":8,"min":1,"max":30,"description":"Products to return"},{"name":"exclude","in":"query","required":false,"type":"string","description":"Comma-separated product_ids to leave out (already shown or rejected)"}]},{"method":"GET","path":"/api/products/{product_id}/tailor","url":"https://www.tailor.ai/api/products/{product_id}/tailor","summary":"A product, altered: 'same but longer / in green / in linen'","description":"Blends the chosen product's embedding with the text of `change`.","parameters":[{"name":"product_id","in":"path","required":true,"type":"string","description":"product_id from a previous result, e.g. 'hm:1757988'"},{"name":"change","in":"query","required":true,"type":"string","description":"Describe the desired RESULT, not just the delta: \"navy blue slim-fit chinos\" beats \"make it navy\"."},{"name":"weight","in":"query","required":false,"type":"number","default":0.6,"min":0,"max":1,"description":"How much `change` steers vs. the original's look. ~0.3 subtle, 0.5 balanced, ~0.65 colour/pattern, ~0.8 different style. Raise it if results ignore the change; lower it if they drift."},{"name":"country","in":"query","required":false,"type":"string","enum":["za","us","gb"],"description":"The shop the person buys from: za = South Africa (prices in ZAR), us = United States (USD), gb = United Kingdom (GBP). Required for search; prices, sizes and delivery follow it."},{"name":"department","in":"query","required":false,"type":"string","enum":["women","men","kids","baby"],"description":"Who it is for — gender / age group. Strongly recommended: without it departments mix."},{"name":"store","in":"query","required":false,"type":"string","enum":["hm","co","zara","mango"],"description":"One retailer: hm = H&M, co = Cotton On, zara = Zara, mango = Mango. Omit for all."},{"name":"type","in":"query","required":false,"type":"string","enum":["tops","t-shirts","shirts-blouses","knitwear","hoodies-sweats","coats-jackets","suits-blazers","dresses","jumpsuits","skirts","jeans","trousers","shorts","activewear","swimwear","sleepwear","underwear","socks-tights","shoes","bags","accessories"],"description":"Hard filter on garment type. Optional — the query text usually suffices."},{"name":"colour","in":"query","required":false,"type":"string","enum":["black","white","grey","blue","green","red","pink","purple","yellow","orange","brown","beige","multi"],"description":"Hard filter on basic colour. For nuanced colours ('sage', 'rust') put them in q instead."},{"name":"brand","in":"query","required":false,"type":"string","description":"Exact brand, e.g. 'H&M', 'ZARA', 'MANGO', 'Cotton On Women', 'Factorie'. See /api/catalog."},{"name":"price_min","in":"query","required":false,"type":"number","min":0,"description":"Minimum price, in the country's currency (needs country)"},{"name":"price_max","in":"query","required":false,"type":"number","min":0,"description":"Maximum price (budget), in the country's currency (needs country)"},{"name":"on_sale","in":"query","required":false,"type":"boolean","description":"true → only discounted products"},{"name":"size","in":"query","required":false,"type":"string","description":"Only products listing this size as available, e.g. 'M', '10', '32'"},{"name":"limit","in":"query","required":false,"type":"integer","default":8,"min":1,"max":30,"description":"Products to return"},{"name":"exclude","in":"query","required":false,"type":"string","description":"Comma-separated product_ids to leave out (already shown or rejected)"}]},{"method":"GET","path":"/api/products/{product_id}","url":"https://www.tailor.ai/api/products/{product_id}","summary":"One product plus its closest alternatives","description":null,"parameters":[{"name":"product_id","in":"path","required":true,"type":"string","description":"product_id from a previous result, e.g. 'hm:1757988'"},{"name":"similar","in":"query","required":false,"type":"integer","default":5,"min":0,"max":12,"description":"How many look-alikes to include"}]},{"method":"GET","path":"/api/catalog","url":"https://www.tailor.ai/api/catalog","summary":"What is in stock: counts per department, store, type, brand, colour; price range","description":"Valid filter values with counts, under any filter combination.","parameters":[{"name":"country","in":"query","required":false,"type":"string","enum":["za","us","gb"],"description":"The shop the person buys from: za = South Africa (prices in ZAR), us = United States (USD), gb = United Kingdom (GBP). Required for search; prices, sizes and delivery follow it."},{"name":"department","in":"query","required":false,"type":"string","enum":["women","men","kids","baby"],"description":"Who it is for — gender / age group. Strongly recommended: without it departments mix."},{"name":"store","in":"query","required":false,"type":"string","enum":["hm","co","zara","mango"],"description":"One retailer: hm = H&M, co = Cotton On, zara = Zara, mango = Mango. Omit for all."},{"name":"type","in":"query","required":false,"type":"string","enum":["tops","t-shirts","shirts-blouses","knitwear","hoodies-sweats","coats-jackets","suits-blazers","dresses","jumpsuits","skirts","jeans","trousers","shorts","activewear","swimwear","sleepwear","underwear","socks-tights","shoes","bags","accessories"],"description":"Hard filter on garment type. Optional — the query text usually suffices."},{"name":"colour","in":"query","required":false,"type":"string","enum":["black","white","grey","blue","green","red","pink","purple","yellow","orange","brown","beige","multi"],"description":"Hard filter on basic colour. For nuanced colours ('sage', 'rust') put them in q instead."},{"name":"brand","in":"query","required":false,"type":"string","description":"Exact brand, e.g. 'H&M', 'ZARA', 'MANGO', 'Cotton On Women', 'Factorie'. See /api/catalog."},{"name":"price_min","in":"query","required":false,"type":"number","min":0,"description":"Minimum price, in the country's currency (needs country)"},{"name":"price_max","in":"query","required":false,"type":"number","min":0,"description":"Maximum price (budget), in the country's currency (needs country)"},{"name":"on_sale","in":"query","required":false,"type":"boolean","description":"true → only discounted products"},{"name":"size","in":"query","required":false,"type":"string","description":"Only products listing this size as available, e.g. 'M', '10', '32'"}]},{"method":"POST","path":"/api/images","url":"https://www.tailor.ai/api/images","summary":"Upload a photo to search by (multipart field 'file')","description":null,"parameters":[]}],"product_fields":{"product_id":"Stable id '<store>:<sku>' (ZA) or '<store>-<country>:<sku>' ('zara-us:…'). Use it in /api/products/{product_id}[/similar|/tailor] and in exclude","title":"string","brand":"string","store":"Retailer name, e.g. 'H&M'","store_code":"hm | co | zara | mango","country":"za | us | gb — which country's shop sells it (and ships within that country)","currency":"ZAR | USD | GBP — every price of this product is in it","department":"Gender / age group: women | men | kids | baby","product_type":"string","colour":"Retailer's colour name","colour_family":"string","price":"Current price, in `currency`","price_display":"Price formatted for people, e.g. 'R1 299', '$49.90', '£25.99'","original_price":"Pre-discount price when on sale","on_sale":"boolean","discount_pct":"number","sizes":"Sizes listed as available when last checked","description":"string","materials":"string","image_url":"string","tailor_url":"The link to show people: tailor.ai page with a link to the store and 5 alternatives","store_url":"Link to the retailer's product page, via tailor.ai/go (logged, then redirected)","links":"object","card_markdown":"Ready-to-paste markdown card for chat replies"},"catalog":{"total_products":62166,"currency":null,"price_range":null,"countries":{"za":{"products":28422,"currency":"ZAR","price_range":{"min":35.0,"max":10999.0,"avg":567.14}},"us":{"products":19233,"currency":"USD","price_range":{"min":1.0,"max":3200.0,"avg":62.61}},"gb":{"products":14511,"currency":"GBP","price_range":{"min":3.0,"max":469.0,"avg":32.94}}},"on_sale":2343,"country":{"za":28422,"us":19233,"gb":14511},"department":{"women":31611,"kids":17373,"men":11531,"baby":1599},"store_code":{"zara":36117,"co":12165,"hm":11330,"mango":2554},"product_type":{"t-shirts":8990,"trousers":6116,"accessories":4198,"tops":3520,"coats-jackets":3515,"knitwear":3503,"shirts-blouses":3412,"shoes":3363,"dresses":3160,"shorts":3136,"jeans":2832,"hoodies-sweats":2404,"underwear":2088,"swimwear":1853,"bags":1679,"skirts":1454,"sleepwear":1041,"suits-blazers":953,"jumpsuits":840,"socks-tights":795,"activewear":83},"brand":{"zara":34515,"h&m":11330,"cotton on kids":3514,"body":3091,"mango":2554,"cotton on women":2207,"rubi":1687,"cotton on men":1665,"massimodutti":1602,"cotton on":1},"colour_family":{"multi":12740,"blue":8373,"white":7998,"black":6521,"brown":5245,"grey":4202,"green":2632,"yellow":2419,"pink":2402,"red":2397,"beige":2330,"purple":719,"orange":488},"product_type_by_department":{"women":{"t-shirts":2968,"accessories":2867,"trousers":2830,"tops":2674,"dresses":2422,"knitwear":1886,"coats-jackets":1780,"shoes":1710,"underwear":1662,"shirts-blouses":1654,"jeans":1454,"swimwear":1248,"shorts":1208,"skirts":1136,"suits-blazers":676,"sleepwear":669,"bags":662,"hoodies-sweats":471,"socks-tights":233,"jumpsuits":198,"activewear":41},"kids":{"t-shirts":3498,"trousers":1960,"hoodies-sweats":1377,"shorts":1146,"shoes":985,"knitwear":914,"jeans":766,"coats-jackets":706,"tops":698,"dresses":636,"bags":562,"shirts-blouses":516,"accessories":457,"swimwear":363,"sleepwear":344,"jumpsuits":325,"socks-tights":320,"skirts":316,"underwear":242,"suits-blazers":43,"activewear":7},"men":{"t-shirts":2350,"shirts-blouses":1230,"trousers":1140,"coats-jackets":1005,"shorts":712,"shoes":623,"accessories":612,"jeans":580,"knitwear":561,"hoodies-sweats":481,"bags":429,"suits-blazers":232,"swimwear":224,"socks-tights":207,"underwear":184,"tops":66,"dresses":55,"activewear":35,"sleepwear":22,"skirts":1},"baby":{"jumpsuits":317,"accessories":256,"trousers":186,"t-shirts":159,"knitwear":139,"tops":82,"hoodies-sweats":75,"shorts":70,"dresses":47,"shoes":45,"jeans":32,"coats-jackets":24,"socks-tights":20,"swimwear":18,"bags":16,"shirts-blouses":12,"sleepwear":6,"suits-blazers":2,"skirts":1}}},"openapi":"https://www.tailor.ai/api/openapi.json","examples":{"search":"https://www.tailor.ai/api/search?q=black+wide-leg+linen+trousers&country=za&department=women&price_max=700","search_uk":"https://www.tailor.ai/api/search?q=black+wide-leg+linen+trousers&country=gb&department=women&price_max=50","browse":"https://www.tailor.ai/api/search?country=us&department=men&type=shoes&on_sale=true","outfit_piece":"https://www.tailor.ai/api/search?q=oversized+cream+cable-knit+jumper&country=za&department=women","similar":"https://www.tailor.ai/api/products/hm:1757988/similar?price_max=400","tailor":"https://www.tailor.ai/api/products/hm:1757988/tailor?change=black+satin+blouse&weight=0.65"}}