# Uniqlo Product API Documentation
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.
- **Documentation:** [https://scrappa.co/docs/uniqlo-api/uniqlo_product](https://scrappa.co/docs/uniqlo-api/uniqlo_product)
- **API group:** Uniqlo API
- **Endpoint:** `GET https://scrappa.co/api/uniqlo/product`
## Authentication
Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Product id like E479000-000. Send this or url. |
| `url` | string | No | Full Uniqlo product page url of a supported region. Send this or id. |
| `price_group` | string | No | Two digit price group of the search item, for example 00 (default) or 01. Taken from the url when you send one. |
| `region` | string | No | Region: us (default) or jp. |
## Example response
```json
{
"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
| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The product does not exist in the chosen region. This response is not billable. |
| 422 | Validation Error | A parameter is missing or invalid, or the filter, page or place matches nothing. This response is not billable. |
| 503 | 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. |
## More Scrappa resources
- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)