uniqlo.products.search
Search Uniqlo France by keyword, filtered by colour, size, price range or markdown, with prices and stock.
At a glance
- Endpoint ID
uniqlo.products.search- Price
- 1 credit per call; failed calls are free
- Runs for up to
- 30 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "uniqlo.products.search", "input": { "limit": 10, "query": "t-shirt" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "uniqlo.products.search", "input": { "limit": 10, "query": "t-shirt" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "uniqlo.products.search", "input": { "limit": 10, "query": "t-shirt" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
query |
string | yes | What to search for, such as pull. | t-shirt |
colors |
array<string> | no | Uniqlo colour codes, such as COL09 for black. | |
include_unavailable |
boolean | no | Keep products that are out of stock. | |
limit |
integer | no | How many products per page. | 10 |
offset |
integer | no | How many products to skip, to get the next page. | |
price_max |
integer | no | The highest price in euros, sent with price_min. | |
price_min |
integer | no | The lowest price in euros, sent with price_max. | |
promo |
boolean | no | Only products with a markdown. | |
sizes |
array<string> | no | Uniqlo size codes, such as SMA004 for M. | |
sort |
integer | no | 0 for Uniqlo's default, 2 for price low to high, 3 for high to low. | 0 · 2 · 3 |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
results[0].data
{ "pagination": { "limit": 10, "offset": 0, "total": 299 }, "raw": { "status": "ok", "result": { "textSearchHitCount": 299, "vectorSearchHitCount": 0, "aggregations": { "tree": { "categories": [ { "name": "Vestes & Manteaux", "id": 150686 }, { "name": "T-shirts, Sweats & Polaires", "id": 150688 } ], "classes": [ { "name": "T-shirts, Sweats & Polaires", "id": 84986 }, { "name": "Chemises, Blouses & Polos", "id": 100139 } ], "genders": [ { "name": "WOMEN", "id": 37608 }, { "name": "MEN", "id": 37609 } ], "subcategories": [ { "name": "Sans manches", "id": 147375 }, { "name": "Manches Courtes", "id": 85760 } ] }, "colors": [ { "name": "BLANC", "code": "COL00", "displayCode": "00", "filterCode": "WHITE", "hexBackgroundColor": "#ffffff", "display": { "chipType": 1, "showFlag": true } }, { "name": "BLANC CASSÉ", "code": "COL01", "displayCode": "01", "filterCode": "WHITE", "hexBackgroundColor": "#ffffff", "display": { "chipType": 1, "showFlag": true } } ], "filterRecommendations": [ { "displayText": "", "facetType": "categories", "groupName": "l1", "queryPath": [ "l1_category_id" ], "values": [ { "name": "37608", "count": 140, "localizationName": "WOMEN" }, { "name": "37609", "count": 128, "localizationName": "MEN" } ] } ], "flags": [ { "name": "Prix en baisse", "code": "discount", "docCount": 111, "id": 12, "rank": 7 }, { "name": "Nouveau", "code": "salesStart", "docCount": 5, "id": 6, "rank": 12 } ], "plds": [ { "name": "-", "code": "PTB000", "displayCode": "000", "docCount": 299 } ], "prices": [ { "count": 299, "from": null, "key": "*-50.0", "to": 50 }, { "count": 0, "from": 50, "key": "50.0-70.0", "to": 70 } ], "ratings": [ { "rating": 0, "accumulated": 262, "count": 1 }, { "rating": 0.5, "accumulated": 261, "count": 0 } ], "sizes": [ { "name": "12-18 mois (80cm)", "code": "BNC080", "displayCode": "080", "display": { "chipType": 1, "showFlag": true } }, { "name": "18-24 mois (90cm)", "code": "BNC090", "displayCode": "090", "display": { "chipType": 1, "showFlag": true } } ], "tags": [ { "docCount": 299, "groupLocalizationName": "Catégorie", "groupName": "category", "values": [ { "name": "outerwear", "docCount": 7, "localizationName": "outerwear" }, { "name": "tops", "docCount": 295, "localizationName": "Tops" } ] }, { "docCount": 218, "groupLocalizationName": "Type de produit", "groupName": "lineup", "values": [ { "name": "jackets", "docCount": 4, "localizationName": "Vestes" }, { "name": "t-shirts", "docCount": 161, "localizationName": "T-shirts" } ] } ] }, "pagination": { "count": 10, "offset": 0, "total": 299 }, "items": [ { "name": "T-shirt oversize AIRism en coton", "genderCategory": "UNISEX", "genderName": "Unisexe", "isTextSearchHit": true, "l1Id": "465185", "priceGroup": "00", "productId": "E465185-000", "promotionText": "", "representativeColorDisplayCode": "39", "sizeGender": "MEN", "storeStockOnly": false, "rating": { "average": 4.8, "count": 6180 }, "images": { "chip": { "00": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_00_465185_chip.jpg", "02": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_02_465185_chip.jpg", "07": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_07_465185_chip.jpg", "09": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_09_465185_chip.jpg", "11": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_11_465185_chip.jpg", "12": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_12_465185_chip.jpg", "15": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_15_465185_chip.jpg", "17": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_17_465185_chip.jpg", "18": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_18_465185_chip.jpg", "19": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_19_465185_chip.jpg", "33": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_33_465185_chip.jpg", "34": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_34_465185_chip.jpg", "35": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_35_465185_chip.jpg", "39": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_39_465185_chip.jpg", "41": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_41_465185_chip.jpg", "42": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_42_465185_chip.jpg", "50": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_50_465185_chip.jpg", "52": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_52_465185_chip.jpg", "53": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_53_465185_chip.jpg", "55": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_55_465185_chip.jpg", "57": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_57_465185_chip.jpg", "58": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_58_465185_chip.jpg", "64": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_64_465185_chip.jpg", "65": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_65_465185_chip.jpg", "66": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_66_465185_chip.jpg", "67": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_67_465185_chip.jpg", "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_69_465185_chip.jpg", "70": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_70_465185_chip.jpg", "71": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_71_465185_chip.jpg", "76": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465185/chip/goods_76_465185_chip.jpg" }, "main": { "00": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_00_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "02": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_02_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "07": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_07_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "09": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_09_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "17": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_17_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "18": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_18_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "39": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_39_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "42": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_42_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "50": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_50_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "58": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_58_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "65": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_65_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "69": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_69_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "70": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_70_465185_3x4.jpg", "model": [ { "modelGender": "Men" } ] } }, "sub": [ { "colorCode": "39", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/sub/eugoods_465185_sub3_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, { "colorCode": "39", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/sub/eugoods_465185_sub6_3x4.jpg", "model": [ { "modelGender": "Women" } ] } ] }, "prices": { "isDualPrice": false, "promo": null, "base": { "value": 19.9, "currency": { "code": "EUR", "symbol": "€" } } }, "representative": { "communicationCode": "465185-39-002-000", "l2Id": "09866271", "sales": true, "color": { "name": "MARRON FONCÉ", "code": "COL39", "displayCode": "39", "filterCode": "BROWN", "display": { "chipType": 1, "showFlag": true } }, "flags": { "priceFlags": [], "productFlags": [ { "name": "Unisexe", "code": "unisex", "flagColor": "normal", "id": 135, "isRepresentativeL2Flag": true, "rank": 103, "type": "product_flag", "effectiveTime": {} } ] }, "pld": { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } }, "size": { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } } }, "colors": [ { "name": "MARRON FONCÉ", "code": "COL39", "displayCode": "39", "filterCode": "BROWN", "display": { "chipType": 1, "showFlag": true } }, { "name": "BLANC", "code": "COL00", "displayCode": "00", "filterCode": "WHITE", "display": { "chipType": 1, "showFlag": true } } ], "plds": [ { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } } ], "sizes": [ { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } }, { "name": "S", "code": "SMA003", "displayCode": "003", "display": { "chipType": 0, "showFlag": true } } ] }, { "name": "T-shirt AIRism en coton (Manches longues)", "genderCategory": "UNISEX", "genderName": "Unisexe", "isTextSearchHit": true, "l1Id": "465193", "priceGroup": "00", "productId": "E465193-000", "promotionText": "", "representativeColorDisplayCode": "16", "sizeGender": "MEN", "storeStockOnly": false, "rating": { "average": 4.8, "count": 1036 }, "images": { "chip": { "00": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_00_465193_chip.jpg", "06": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_06_465193_chip.jpg", "08": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_08_465193_chip.jpg", "09": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_09_465193_chip.jpg", "11": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_11_465193_chip.jpg", "12": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_12_465193_chip.jpg", "16": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_16_465193_chip.jpg", "19": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_19_465193_chip.jpg", "30": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_30_465193_chip.jpg", "39": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_39_465193_chip.jpg", "52": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_52_465193_chip.jpg", "56": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_56_465193_chip.jpg", "58": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_58_465193_chip.jpg", "65": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_65_465193_chip.jpg", "68": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_68_465193_chip.jpg", "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_69_465193_chip.jpg", "70": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_70_465193_chip.jpg", "75": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_75_465193_chip.jpg", "76": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_76_465193_chip.jpg", "77": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/chip/goods_77_465193_chip.jpg" }, "main": { "00": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_00_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "08": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_08_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "09": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_09_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "16": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_16_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "30": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_30_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "39": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_39_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "65": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_65_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] }, "68": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_68_465193_3x4.jpg", "model": [ { "modelGender": "Men" } ] } }, "sub": [ { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465193/sub/goods_465193_sub1_3x4.jpg", "model": [] }, { "colorCode": "16", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/sub/eugoods_465193_sub3_3x4.jpg", "model": [ { "modelGender": "Men" } ] } ] }, "prices": { "isDualPrice": false, "promo": null, "base": { "value": 24.9, "currency": { "code": "EUR", "symbol": "€" } } }, "representative": { "communicationCode": "465193-16-002-000", "l2Id": "09458935", "sales": true, "color": { "name": "ROUGE", "code": "COL16", "displayCode": "16", "filterCode": "RED", "display": { "chipType": 1, "showFlag": true } }, "flags": { "priceFlags": [], "productFlags": [ { "name": "Unisexe", "code": "unisex", "flagColor": "normal", "id": 135, "isRepresentativeL2Flag": true, "rank": 103, "type": "product_flag", "effectiveTime": {} } ] }, "pld": { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } }, "size": { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } } }, "colors": [ { "name": "ROUGE", "code": "COL16", "displayCode": "16", "filterCode": "RED", "display": { "chipType": 1, "showFlag": true } }, { "name": "BLANC", "code": "COL00", "displayCode": "00", "filterCode": "WHITE", "display": { "chipType": 1, "showFlag": true } } ], "plds": [ { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } } ], "sizes": [ { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } }, { "name": "S", "code": "SMA003", "displayCode": "003", "display": { "chipType": 0, "showFlag": true } } ] } ], "relatedKeywords": [ "t-shirts manches longues", "Sweat-shirt à capuche homme" ], "relaxedQueries": [ "t-shirt" ], "relaxedQueryItems": [] } }, "items": [ { "name": "T-shirt oversize AIRism en coton", "currency": "EUR", "image_url": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugoods_39_465185_3x4.jpg", "in_stock": true, "model_id": "465185", "price_base": 19.9, "price_promo": null, "product_id": "E465185-000", "rating_average": 4.8, "rating_count": 6180, "url": "https://www.uniqlo.com/fr/fr/products/E465185-000/00", "colors": [ { "name": "MARRON FONCÉ", "available": null, "code": "COL39", "display_code": "39", "display_visible": true }, { "name": "BLANC", "available": null, "code": "COL00", "display_code": "00", "display_visible": true } ], "sizes": [ { "name": "XS", "available": null, "code": "SMA002", "display_code": "002", "display_visible": true }, { "name": "S", "available": null, "code": "SMA003", "display_code": "003", "display_visible": true } ] }, { "name": "T-shirt AIRism en coton (Manches longues)", "currency": "EUR", "image_url": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugoods_16_465193_3x4.jpg", "in_stock": true, "model_id": "465193", "price_base": 24.9, "price_promo": null, "product_id": "E465193-000", "rating_average": 4.8, "rating_count": 1036, "url": "https://www.uniqlo.com/fr/fr/products/E465193-000/00", "colors": [ { "name": "ROUGE", "available": null, "code": "COL16", "display_code": "16", "display_visible": true }, { "name": "BLANC", "available": null, "code": "COL00", "display_code": "00", "display_visible": true } ], "sizes": [ { "name": "XS", "available": null, "code": "SMA002", "display_code": "002", "display_visible": true }, { "name": "S", "available": null, "code": "SMA003", "display_code": "003", "display_visible": true } ] } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
items[].colors[].name |
string | The colour's name. | MARRON FONCÉ |
items[].name |
string | The name as Uniqlo shows it. | T-shirt oversize AIRism en coton |
items[].sizes[].name |
string | The size, such as XS. | XS |
items[].colors |
array | The colours the product comes in. | 3 records |
items[].colors[].available |
null | Stock for this colour; empty here, the product endpoint has it. | null |
items[].colors[].code |
string | Uniqlo's code for the colour. | COL39 |
items[].colors[].display_code |
string | The colour number as Uniqlo shows it. | 39 |
items[].colors[].display_visible |
boolean | Whether Uniqlo shows this colour. | true |
items[].currency |
string | The currency code of the prices. | EUR |
items[].image_url |
string | The product's picture. | https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugo… |
items[].in_stock |
boolean | Whether the product can be bought now. | true |
items[].model_id |
string | Uniqlo's ID for the product model. | 465185 |
items[].price_base |
number | The regular price, in the currency given. | 19.9 |
items[].price_promo |
null | The offer price, when there is one. | null |
items[].product_id |
string | Uniqlo's ID for the product; the product endpoint takes it. | E465185-000 |
items[].rating_average |
number | The average star rating. | 4.8 |
items[].rating_count |
integer | How many ratings the product has. | 6180 |
items[].sizes |
array | The sizes the product comes in. | 3 records |
items[].sizes[].available |
null | Stock for this size; empty here, the product endpoint has it. | null |
items[].sizes[].code |
string | Uniqlo's code for the size. | SMA002 |
items[].sizes[].display_code |
string | The size number as Uniqlo shows it. | 002 |
items[].sizes[].display_visible |
boolean | Whether Uniqlo shows this size. | true |
items[].url |
string | The product's page on Uniqlo. | https://www.uniqlo.com/fr/fr/products/E465185-000/00 |
items |
array | The products. | 3 records |
pagination |
object | Paging for this response. | 3 fields |
pagination.limit |
integer | How many products one page holds. | 10 |
pagination.offset |
integer | Where this page starts; add the limit to get the next page. | 0 |
pagination.total |
integer | How many products match. | 299 |
raw |
object | Uniqlo's own response, as it came back. | 2 fields |
raw.result |
object | The search result itself. | 8 fields |
raw.result.aggregations |
object | Filter options for the search, such as colours, sizes and prices. | 9 fields |
raw.result.items |
array | The products. | 3 records |
raw.result.pagination |
object | Paging for this response. | 3 fields |
raw.result.relatedKeywords |
array | Searches Uniqlo suggests alongside this one. | t-shirts manches longues, Sweat-shirt à capuche homme, t-shirts… |
raw.result.relaxedQueries |
array | Broader forms of your search that Uniqlo used. | t-shirt |
raw.result.relaxedQueryItems |
array | Products found by the broader search, when any. | empty in this sample |
raw.result.textSearchHitCount |
integer | How many products matched the words searched. | 299 |
raw.result.vectorSearchHitCount |
integer | How many products Uniqlo matched by meaning. | 0 |
raw.status |
string | Whether Uniqlo answered normally, such as ok. | ok |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Uniqlo endpoints
Something missing or unclear? Ask the team that builds the Uniqlo endpoints.