uniqlo.com APIwww.uniqlo.com ↗
Search Uniqlo US products, fetch full product details, and browse categories. Get pricing, colors, sizes, ratings, and images via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/71e9d7ce-e5f0-47c7-94da-c7e2aa3ed1ad/search_products?limit=3&query=jacket§ion=men' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional section filter and pagination. Returns paginated product results with pricing, colors, sizes, and ratings.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results per page (max 100) |
| queryrequired | string | Search keyword (e.g., 't-shirt', 'jacket', 'jeans') |
| offset | integer | Offset for pagination (starts at 0) |
| section | string | Filter by section: 'women', 'men', 'kids', or 'baby' |
{
"type": "object",
"fields": {
"count": "integer - items returned in this page",
"total": "integer - total matching products",
"offset": "integer - current offset",
"products": "array of product objects with product_id, price_group, name, gender, base_price, promo_price, currency, colors, sizes, rating_average, rating_count, main_image, product_url"
},
"sample": {
"data": {
"count": 3,
"total": 58,
"offset": 0,
"products": [
{
"name": "Zip-Up Short Jacket",
"sizes": [
{
"code": "003",
"name": "S"
}
],
"colors": [
{
"code": "32",
"name": "BEIGE"
}
],
"gender": "WOMEN",
"currency": "USD",
"base_price": 59.9,
"main_image": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479208/item/usgoods_32_479208_3x4.jpg",
"product_id": "E479208-000",
"price_group": "00",
"product_url": "https://www.uniqlo.com/us/en/products/E479208-000/00",
"promo_price": null,
"rating_count": 258,
"rating_average": 4.8
}
]
},
"status": "success"
}
}About the uniqlo.com API
This API provides structured access to the Uniqlo US online store catalog across 3 endpoints, covering product search, product details, and category navigation. The search_products endpoint returns paginated results with pricing, available colors, sizes, and average ratings. The get_product_details endpoint exposes per-product data including composition, breadcrumbs, fit ratings, and multiple image URLs.
Endpoints and Data Coverage
The API covers three areas of the Uniqlo US catalog. search_products accepts a required query string and optional section filter (women, men, kids, or baby), returning paginated results with total count, offset, and an array of product objects. Each product includes product_id, name, base_price, promo_price, currency, colors, sizes, gender, price_group, and rating_aver. Pagination is controlled via limit (up to 100) and offset.
Product Details
get_product_details accepts either a bare numeric ID like 465193 or a full-format ID like E479208-000 — the endpoint normalizes both forms to the canonical E{id}-000 format internally. The response adds fields not available in search results: sub_images (array of additional image URLs), breadcrumbs (gender, class, category, subcategory strings), fit_rating, and composition. The optional price_group parameter defaults to 00, which is the only reliably supported value; passing other values may result in a not-found error.
Category Navigation
get_categories takes no inputs and returns a sections object keyed by Women, Men, and Kids & Baby. Each section contains an array of category objects with name, url, and a subcategories array — useful for building navigation trees or seeding product searches with canonical category names. This endpoint reflects the top-level taxonomy of the Uniqlo US site as currently structured.
- Build a cross-brand price comparison tool using
base_priceandpromo_pricefields fromsearch_products - Populate a product catalog page with images, colors, and sizes pulled from
get_product_details - Implement a Uniqlo-specific search interface filtered by section (
men,women,kids,baby) - Track promotional pricing changes over time by polling
promo_pricefor specific product IDs - Generate a structured category sitemap using the
sectionsandsubcategoriesdata fromget_categories - Filter apparel by size availability using the
sizesarray returned in search and detail endpoints - Display fit and satisfaction signals in a product UI using
fit_ratingandrating_averfields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Uniqlo offer an official public developer API?+
What does `get_product_details` return beyond what `search_products` provides?+
get_product_details adds several fields not present in search results: sub_images (additional product image URLs), breadcrumbs (structured category path with gender, class, category, and subcategory), fit_rating, and material composition. Search results include rating_aver but not the full image gallery or breadcrumb hierarchy.Does the API cover Uniqlo stores outside the US, such as the UK, Japan, or EU regions?+
Is stock availability or inventory level exposed for each product?+
How does pagination work in `search_products`?+
offset parameter to page through results, starting at 0. The limit parameter controls how many results are returned per page, up to a maximum of 100. The response includes total (the full matching product count) and count (items returned in the current page), so you can calculate how many additional pages exist.