uniqlo.product.get
Get one product's price and availability for each colour and size, from its ID or URL.
At a glance
- Endpoint ID
uniqlo.product.get- 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.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));
Input
| 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
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
{ "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" } ]}
Fields
| 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 |
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.