Uniqlo API · Endpoint
Uniqlo Product Detail API
Get one product's price and availability for each colour and size, from its ID or URL.
- 1 credit per call
- Failed calls are free
- Updated
- uniqlo.product.get
Response
completed
{ "url": "https://www.uniqlo.com/fr/fr/products/E487001-000", "raw": { "status": "ok", "result": { "name": "Cardigan à encolure arrondie (Manches courtes)", "careInstruction": "<br>", "composition": "60% Coton, 40% Modal", "designDetail": "", "freeInformation": "", "genderCategory": "WOMEN", "genderName": "Femme", "longDescription": "- Coupe courte et ajustée.", "priceGroup": "00", "productId": "E487001-000", "productType": "unknown", "productTypeKr": "", "promoConditionText": "", "promoId": "", "promotionText": "", "shortDescription": "", "sizeChartUrl": "https://www.uniqlo.com/fr/fr/size/487001_size.html", "sizeInformation": "", "taxPolicy": "INCLUSIVE", "washingInformation": "Lavage en machine sur cycle délicat à une température maximale de 40 °C, Lavage à sec, Ne convient pas au séchage en machine.", "writeReviewAvailable": true, "rating": { "average": 4.8, "count": 130, "fit": 2.95, "rateCount": { "five": 113, "four": 13, "one": 0, "three": 4, "two": 0 } }, "breadcrumbs": { "category": { "name": "jumpers", "id": "100104", "level": 3, "locale": "Pulls" }, "class": { "name": "jumpers", "id": "100103", "level": 2, "locale": "Pulls & Cardigans" }, "gender": { "name": "women", "id": "37608", "level": 1, "locale": "WOMEN" }, "subcategory": { "name": "short half sleeve", "id": "100117", "level": 4, "locale": "Manches 3/4" } }, "images": { "chip": { "01": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_01_487001_chip.jpg", "42": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_42_487001_chip.jpg", "58": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_58_487001_chip.jpg", "60": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_60_487001_chip.jpg", "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_69_487001_chip.jpg" }, "main": { "01": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_01_487001_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "1149", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "174" }, "us": { "height": "68.5" } }, "products": [ { "colorCode": "01", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "30", "itemId": "488852", "sampleCode": "226F215A", "sizeCode": "SMA004" } ] } ], "productCombinations": [] }, "42": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_42_487001_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "1462", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "174" }, "us": { "height": "68.5" } }, "products": [ { "colorCode": "42", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "488867", "sampleCode": "226F117B", "sizeCode": "SMA004" } ] } ], "productCombinations": [] }, "58": { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/item/goods_58_487001_3x4.jpg", "showProductsInImageLink": false, "model": [], "productCombinations": [] }, "60": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_60_487001_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "1224", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "170" }, "us": { "height": "66.9" } }, "products": [ { "colorCode": "60", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "38", "itemId": "486095", "sampleCode": "276F115A", "sizeCode": "SMA004" } ] } ], "productCombinations": [] }, "69": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_69_487001_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "893", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" } ] } ], "productCombinations": [] } }, "sub": [ { "colorCode": "69", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub3_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "893", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" } ] } ] }, { "colorCode": "69", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub4_3x4.jpg", "showProductsInImageLink": true, "gender": [ "Women" ], "model": [ { "modelGender": "Women", "modelId": "893", "modelExpirationDate": { "nh": "", "sh": "" }, "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" } ] } ] } ] }, "prices": { "discountPercentage": null, "isDualPrice": true, "taxPolicy": "INCLUSIVE", "base": { "value": 29.9, "currency": { "code": "EUR", "symbol": "€" } }, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "value": 12.9, "currency": { "code": "EUR", "symbol": "€" } } }, "productSync": {}, "representative": { "l2Id": "09431828", "sales": true, "color": { "name": "BLEU MARINE", "code": "COL69", "displayCode": "69", "filterCode": "BLUE", "display": { "chipType": 1, "showFlag": true } }, "flags": { "priceFlags": [ { "name": "Prix en baisse", "code": "discount", "detail": "", "id": 12, "type": "price_flag", "effectiveTime": { "end": 0, "start": 1791849600 } } ], "productFlags": [] }, "pld": { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } }, "size": { "name": "XXS", "code": "SMA001", "displayCode": "001", "display": { "chipType": 0, "showFlag": true } } }, "colors": [ { "name": "BLANC CASSÉ", "code": "COL01", "displayCode": "01", "filterCode": "WHITE", "display": { "chipType": 1, "showFlag": true } }, { "name": "JAUNE", "code": "COL42", "displayCode": "42", "filterCode": "YELLOW", "display": { "chipType": 1, "showFlag": true } } ], "countriesOfOrigin": [ { "code": "CN", "lid": "text_country_cn" }, { "code": "VN", "lid": "text_country_vn" } ], "l1Ids": [ "487001" ], "l2s": [ { "communicationCode": "487001-01-001-000", "l2Id": "09431748", "sales": true, "salesType": "NORMAL", "searchInStoresAvailable": true, "alterations": {}, "color": { "name": "BLANC CASSÉ", "code": "COL01", "displayCode": "01", "filterCode": "WHITE", "display": { "chipType": 1, "showFlag": true } }, "flags": { "priceFlags": [ { "name": "Prix en baisse", "code": "discount", "detail": "", "id": 12, "type": "price_flag", "effectiveTime": { "end": 0, "start": 1791849600 } } ], "productFlags": [] }, "pld": { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } }, "prices": { "discountPercentage": null, "isDualPrice": true, "taxPolicy": "INCLUSIVE", "base": { "value": 29.9, "currency": { "code": "EUR", "symbol": "€" } }, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "value": 12.9, "currency": { "code": "EUR", "symbol": "€" } } }, "size": { "name": "XXS", "code": "SMA001", "displayCode": "001", "display": { "chipType": 0, "showFlag": true } } }, { "communicationCode": "487001-01-002-000", "l2Id": "09431749", "sales": true, "salesType": "NORMAL", "searchInStoresAvailable": true, "alterations": {}, "color": { "name": "BLANC CASSÉ", "code": "COL01", "displayCode": "01", "filterCode": "WHITE", "display": { "chipType": 1, "showFlag": true } }, "flags": { "priceFlags": [ { "name": "Prix en baisse", "code": "discount", "detail": "", "id": 12, "type": "price_flag", "effectiveTime": { "end": 0, "start": 1791849600 } } ], "productFlags": [] }, "pld": { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } }, "prices": { "discountPercentage": null, "isDualPrice": true, "taxPolicy": "INCLUSIVE", "base": { "value": 29.9, "currency": { "code": "EUR", "symbol": "€" } }, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "value": 12.9, "currency": { "code": "EUR", "symbol": "€" } } }, "size": { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } } } ], "nextModelProducts": [], "plds": [ { "name": "-", "code": "PTB000", "displayCode": "000", "display": { "chipType": 0, "showFlag": false } } ], "sizes": [ { "name": "XXS", "code": "SMA001", "displayCode": "001", "display": { "chipType": 0, "showFlag": true } }, { "name": "XS", "code": "SMA002", "displayCode": "002", "display": { "chipType": 0, "showFlag": true } } ], "tags": [], "topCategories": [ "women" ] } }, "skus": [ { "available": true, "color_code": "COL01", "color_name": "BLANC CASSÉ", "currency": "EUR", "price_base": 29.9, "price_promo": 12.9, "size_code": "SMA001", "size_name": "XXS" }, { "available": true, "color_code": "COL01", "color_name": "BLANC CASSÉ", "currency": "EUR", "price_base": 29.9, "price_promo": 12.9, "size_code": "SMA002", "size_name": "XS" } ]}
| # | Available | Color code | Color name | Currency | Price base | Price promo | Size code | Size name |
|---|---|---|---|---|---|---|---|---|
| 1 | true | COL01 | BLANC CASSÉ | EUR | 29.9 | 12.9 | SMA001 | XXS |
| 2 | true | COL01 | BLANC CASSÉ | EUR | 29.9 | 12.9 | SMA002 | XS |
| 3 | true | COL01 | BLANC CASSÉ | EUR | 29.9 | 12.9 | SMA003 | S |
Input
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| product_id | string | one of | The product's ID, such as E488210-000. | E487001-000 |
| url | string | one of | The product's Uniqlo France page, as an alternative to the ID. |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| skus[].available | boolean | Whether this colour, size or version can be bought now. | true |
| skus[].color_code | string | Uniqlo's code for the colour. | COL01 |
| skus[].color_name | string | The colour's name. | BLANC CASSÉ |
| skus[].currency | string | The currency code of the prices. | EUR |
| skus[].price_base | number | The regular price, in the currency given. | 29.9 |
| skus[].price_promo | number | The offer price, when there is one. | 12.9 |
| skus[].size_code | string | Uniqlo's code for the size. | SMA001 |
| skus[].size_name | string | The size. | XXS |
| raw | object | Uniqlo's own response, as it came back. | 2 fields |
| raw.result | object | The product record itself. | 36 fields |
| raw.result.breadcrumbs | object | Where the product sits in Uniqlo's categories. | 4 fields |
| raw.result.careInstruction | string | Care instructions as Uniqlo writes them, when given. | <br> |
| raw.result.colors | array | The colours the product comes in. | 3 records |
| raw.result.composition | string | What the product is made of. | 60% Coton, 40% Modal |
| raw.result.countriesOfOrigin | array | Where the product is made. | 2 records |
| raw.result.designDetail | string | Design details, when Uniqlo gives them. | |
| raw.result.freeInformation | string | Extra notes on the product, when Uniqlo adds any. | |
| raw.result.genderCategory | string | The department, such as WOMEN. | WOMEN |
| raw.result.genderName | string | The department, as Uniqlo names it. | Femme |
| raw.result.images | object | Links to the product's pictures and colour swatches. | 3 fields |
| raw.result.l1Ids | array | Uniqlo's product numbers for this item. | 487001 |
| raw.result.l2s | array | Every colour and size combination, as Uniqlo lists it. | 3 records |
| raw.result.longDescription | string | The product description. | - Coupe courte et ajustée. |
| raw.result.name | string | The name as Uniqlo shows it. | Cardigan à encolure arrondie (Manches courtes) |
| raw.result.nextModelProducts | array | Products Uniqlo lists as the next model, when any. | empty in this sample |
| raw.result.plds | array | A third option such as length; a dash means none. | 1 records |
| raw.result.priceGroup | string | Uniqlo's price group code, also used in product links. | 00 |
| raw.result.prices | object | The product's prices, as Uniqlo gives them. | 6 fields |
| raw.result.productId | string | Uniqlo's ID for the product. | E487001-000 |
| raw.result.productSync | object | A Uniqlo field that is empty for most products. | 0 fields |
| raw.result.productType | string | Uniqlo's product type label, often unknown. | unknown |
| raw.result.productTypeKr | string | A product type label, empty on the France store. | |
| raw.result.promoConditionText | string | The terms of a promotion, when any. | |
| raw.result.promoId | string | Uniqlo's ID for the promotion, when any. | |
| raw.result.promotionText | string | The promotion text shown, when any. | |
| raw.result.rating | object | Rating average, count, fit score and star split. | 4 fields |
| raw.result.representative | object | The colour, size and stock Uniqlo shows first. | 6 fields |
| raw.result.shortDescription | string | A short product description, when given. | |
| raw.result.sizeChartUrl | string | The product's size chart. | https://www.uniqlo.com/fr/fr/size/487001_size.html |
| raw.result.sizeInformation | string | Size notes, when Uniqlo gives them. | |
| raw.result.sizes | array | The sizes the product comes in. | 3 records |
| raw.result.tags | array | Labels on the product, when any. | empty in this sample |
| raw.result.taxPolicy | string | Whether prices include tax, such as INCLUSIVE. | INCLUSIVE |
| raw.result.topCategories | array | The departments the product is in, such as women. | women |
| raw.result.washingInformation | string | How to wash the product. | Lavage en machine sur cycle délicat à une température maximale … |
| raw.result.writeReviewAvailable | boolean | Whether shoppers can review the product. | true |
| raw.status | string | Whether Uniqlo answered normally, such as ok. | ok |
| skus | array | Every colour and size combination with its price and stock. | 3 records |
| url | string | The product's page on Uniqlo. | https://www.uniqlo.com/fr/fr/products/E487001-000 |
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.product.get", "input": { "product_id": "E487001-000" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "uniqlo.product.get", "input": { "product_id": "E487001-000" }}''')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.product.get", "input": { "product_id": "E487001-000" }}),});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 detail for product id "E487001-000". 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 UKProduct detail
Amazon CommerceProduct
AsdaProduct detail
BlinkitProduct
Flipkart CommerceProduct
Flipkart MinutesLocal product details
Questions
Uniqlo Product Detail 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 Detail 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 product_id or url. 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.product.get, 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.