Uniqlo Product API returns one product by id or product url: name, description, composition, care, design details, size chart link, country of origin, category path, price, sale price and discount, rating with split, images, colours, sizes, and one variant per colour and size with the stock quantity and status. It also returns a review summary and the latest five customer reviews.
Use the product_id and the price_group of a search item (or its url): Uniqlo prices one product per price group, 00 is the regular price and 01 is often a sale price with other stock. Without a group, 00 is used. For an item in a sale price group the regular price of group 00 is read to fill original_price, sale_price and discount_percent. The l2_id of a variant works in the store stock route. The answer is one lookup unit and costs 1 credit. If the reviews are not available, they are null and the product is still returned.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
4 optional filters available.
string
Optional
Product id like E479000-000. Send this or url.
1234567890
string
Optional
Full Uniqlo product page url of a supported region. Send this or id.
https://example.com/product
string
Optional
Two digit price group of the search item, for example 00 (default) or 01. Taken from the url when you send one.
example
string
Optional
Region: us (default) or jp.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"url": "https://www.uniqlo.com/us/en/products/E479000-000/00",
"care": "Machine wash cold, gentle cycle, Do not dry clean",
"name": "Barrel Jeans",
"price": {
"amount": 39.9,
"on_sale": false,
"currency": "USD",
"sale_price": null,
"original_price": null,
"discount_percent": null
},
"sizes": [
{
"code": "INS022",
"name": "22inch"
},
{
"code": "INS023",
"name": "23inch"
},
{
"code": "INS024",
"name": "24inch"
}
],
"colors": [
{
"code": "COL04",
"name": "GRAY",
"image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_04_479000_3x4.jpg",
"swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/479000/chip/goods_04_479000_chip.jpg",
"color_group": "GRAY",
"display_code": "04"
},
{
"code": "COL08",
"name": "DARK GRAY",
"image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_08_479000_3x4.jpg",
"swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/479000/chip/goods_08_479000_chip.jpg",
"color_group": "GRAY",
"display_code": "08"
}
],
"gender": "unisex",
"images": {
"main": [
{
"url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_12_479000_3x4.jpg",
"color": "12"
}
],
"videos": [
"https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/subvideo/usgoods_479000_sub13_video_3x4.mp4"
],
"gallery": [
{
"url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/sub/usgoods_479000_sub1_3x4.jpg",
"color": "67"
}
],
"features": [
{
"url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/feature/usgoods_479000_feature6.jpg",
"text": "Softly curved silhouette with a high waist and volume at the sides. Great for all ages."
}
]
},
"rating": {
"fit": 3.17,
"count": 591,
"average": 4.7,
"distribution": {
"1": 11,
"2": 6,
"3": 10,
"4": 48,
"5": 516
}
},
"region": "us",
"reviews": {
"tags": [
{
"name": "Fit",
"count": 282
},
{
"name": "Comfort",
"count": 179
},
{
"name": "Length",
"count": 151
}
],
"items": [
{
"fit": 3,
"title": "comfortable",
"author": "dette",
"rating": 5,
"comment": "I love the material because it is extremely comfortable and soft! I am 5\u201d4 and 120lbs, I bought the Size 25 and it is perfect! Most of my jeans are from Uniqlo and I get compliments everytime!",
"location": "California",
"review_id": "16989550",
"created_at": "2026-10-31T20:09:49Z",
"helpful_count": 0,
"purchased_size": "25inch",
"purchased_color": "04 GRAY"
}
],
"total": 591,
"summary": "Loved for the soft, breathable denim that drapes well and works for casual outings, dining out, and everyday wear, while the fabric stretches out over the day and may require a dryer refresh between wears."
},
"variants": [
{
"l2_id": "09463522",
"price": {
"amount": 39.9,
"on_sale": false,
"currency": "USD",
"sale_price": null,
"original_price": null,
"discount_percent": null
},
"labels": [
"Limited-Time Offer until 11/4"
],
"status": "In stock",
"in_stock": true,
"quantity": 11,
"size_code": "INS022",
"size_name": "22inch",
"color_code": "COL04",
"color_name": "GRAY",
"status_code": "IN_STOCK",
"store_pickup_search": true
},
{
"l2_id": "09463523",
"price": {
"amount": 39.9,
"on_sale": false,
"currency": "USD",
"sale_price": null,
"original_price": null,
"discount_percent": null
},
"labels": [
"Limited-Time Offer until 11/4"
],
"status": "Out of stock",
"in_stock": false,
"quantity": 0,
"size_code": "INS023",
"size_name": "23inch",
"color_code": "COL04",
"color_name": "GRAY",
"status_code": "STOCK_OUT",
"store_pickup_search": true
}
],
"size_info": null,
"categories": [
{
"id": "22210",
"key": "women",
"name": "Women",
"level": 1
},
{
"id": "23296",
"key": "bottoms",
"name": "Bottoms",
"level": 2
},
{
"id": "23339",
"key": "jeans",
"name": "Jeans",
"level": 3
},
{
"id": "139739",
"key": "barrel",
"name": "Barrel",
"level": 4
}
],
"product_id": "E479000-000",
"composition": "This item ships with one of the below options. Note that you cannot specify a preference at this time.\n479000, 482280: [00 WHITE] 75% Cotton, 25% Lyocell\n[08 DARK GRAY, 62 BLUE, 67 BLUE] 79% Cotton, 2...",
"description": "Our women\u2019s Barrel Jeans are high\u2011waist, barrel\u2011leg denim jeans designed to deliver modern shape with everyday comfort. Made from a soft cotton\u2011blend denim, they feel smooth and wearable year\u2011round while maintaining clean structure.\n\nA gent...",
"price_group": "00",
"design_details": "- Sheer: Not Sheer(Only 00 White is slightly sheer)\n- Fit: Loose\n- Silhouette: Barrel\n- Pockets: With Pockets\n- Rise: High",
"is_best_seller": false,
"size_chart_url": "https://www.uniqlo.com/us/en/size/479000_size.html",
"countries_of_origin": [
"BD"
]
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Not Found
The product does not exist in the chosen region. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Validation Error
A parameter is missing or invalid, or the filter, page or place matches nothing. This response is not billable.
{
"errors": {
"id": [
"The id must look like E479000-000."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Uniqlo could not be reached, or it returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Uniqlo could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.