Uniqlo API · Endpoint
Uniqlo Product Keyword Search API
Search Uniqlo France by keyword, filtered by colour, size, price range or markdown, with prices and stock.
- 1 credit per call
- Failed calls are free
- Updated
- uniqlo.products.search
Response
completed
{ "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 } ] } ]}
| # | Name | Currency | In stock | Price base | Rating average | Rating count | Image url | Model id | Product id | Url |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | T-shirt oversize AIRism en coton | EUR | true | 19.9 | 4.8 | 6180 | https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465185/item/eugo… | 465185 | E465185-000 | https://www.uniqlo.com/fr/fr/products/E465185-000/00 |
| 2 | T-shirt AIRism en coton (Manches longues) | EUR | true | 24.9 | 4.8 | 1036 | https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465193/item/eugo… | 465193 | E465193-000 | https://www.uniqlo.com/fr/fr/products/E465193-000/00 |
| 3 | T-shirt AIRism en coton (Manches longues, rayé) | EUR | true | 24.9 | 4.9 | 38 | https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/486103/item/eugo… | 487505 | E486103-000 | https://www.uniqlo.com/fr/fr/products/E486103-000/00 |
Input
What you send
The input
object of the request, with every field the endpoint accepts.
| 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
Fields it returns
What each record in the response holds, with the values from the sample above.
| 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 |
REST API · MCP server
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
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));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
With Upscrape, get the Uniqlo product keyword search for query "t-shirt". Tell me what it costs before you run it, then show the results as a table.
Uniqlo
More from the Uniqlo API
Same data, other platforms
The same data from other platforms
Aldi UKCategory products
Amazon CommerceListings search
AsdaCategory products
BlinkitCategory products
Flipkart CommerceCategory products
Flipkart MinutesCategory products
Questions
Uniqlo Product Keyword Search API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the Uniqlo Product Keyword Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need an Uniqlo login?
No. It reads public Uniqlo data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds uniqlo.products.search, checks its price and runs it with the same credits as the REST API.
Get started
Your first Uniqlo call is free.
Up to 100 free credits to start, no card needed.