Uniqlo APIuniqlo.com ↗
Access Uniqlo US product listings, search the catalog, and browse category trees via API. Returns pricing, colors, sizes, ratings, and images.
What is the Uniqlo API?
The Uniqlo US API covers 4 endpoints that expose product listings, full-text search, detailed product data, and the complete category tree from uniqlo.com/us/en. The get_product_details endpoint alone returns over 12 distinct fields per product, including material composition, care instructions, color-specific image URLs, breadcrumb navigation, and customer fit ratings. Use it to build catalog browsers, price trackers, or size-availability monitors without visiting the storefront.
curl -X GET 'https://api.parse.bot/scraper/71e9d7ce-e5f0-47c7-94da-c7e2aa3ed1ad/search_products?limit=5&query=t-shirt&offset=0§ion=women' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace uniqlo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Uniqlo US SDK — browse catalog, search, get details."""
from parse_apis.Uniqlo_US_Store_API import Uniqlo, Section, ProductNotFound
client = Uniqlo()
# Browse the full catalog, capped at 3 items
for listing in client.product_listings.list(section=Section.WOMEN, limit=3):
print(listing.title, listing.price, listing.sale_price, listing.availability)
# Search for a specific product then refresh for full details
product = client.products.search(query="t-shirt", section=Section.MEN, limit=1).first()
if product:
detail = product.refresh()
print(detail.name, detail.base_price, detail.composition)
for color in detail.colors[:3]:
print(color.code, color.name)
# Handle a product that doesn't exist
try:
client.products.get(product_id="9999999")
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
# Browse the category tree
catalog = client.catalogs.get()
for section_name, categories in catalog.sections.items():
for cat in categories[:2]:
print(section_name, cat.name, cat.url)
print("exercised: product_listings.list / products.search / product.refresh / products.get / catalogs.get")
Full-text search over the Uniqlo US product catalog. Matches product names and descriptions against the query keyword. Results are paginated via offset; each product includes pricing, available colors/sizes, and rating. An optional section filter narrows results to a single gender department.
| 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'. Empty string returns all sections. |
{
"type": "object",
"fields": {
"count": "integer - items returned in this page",
"total": "integer - total matching products",
"offset": "integer - current offset",
"products": "array of ProductSummary objects"
},
"sample": {
"data": {
"count": 5,
"total": 620,
"offset": 0,
"products": [
{
"name": "AIRism Cotton T-Shirt | Long Sleeve",
"sizes": [
{
"code": "001",
"name": "XXS"
}
],
"colors": [
{
"code": "68",
"name": "BLUE"
}
],
"gender": "UNISEX",
"currency": "USD",
"base_price": 29.9,
"main_image": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/465193/item/usgoods_68_465193_3x4.jpg",
"product_id": "E465193-000",
"price_group": "00",
"product_url": "https://www.uniqlo.com/us/en/products/E465193-000/00",
"promo_price": null,
"rating_count": 621,
"rating_average": 4.8
}
]
},
"status": "success"
}
}About the Uniqlo API
Catalog Browsing and Search
The list_products endpoint pages through the entire Uniqlo US catalog, returning a lightweight summary per item: title, base price, sale price, currency, availability status, product page URL, and main image URL. Pagination is controlled via offset and limit (up to 100 per request), and an optional section parameter narrows results to women, men, kids, or baby. The search_products endpoint runs a full-text match against product names and descriptions given a query string, with the same pagination and section-filter options. Both endpoints return a total field so you can determine how many pages to walk.
Product Details
get_product_details accepts either a bare numeric ID (e.g. 465193) or the canonical format (e.g. E465193-000) and returns the complete record for that product. Response fields include name, base_price, currency, gender, arrays of colors and sizes with code/name pairs, sub_images keyed per color, breadcrumbs (with gender, class, category, and subcategory strings), fit_rating, and material/care detail. The optional price_group parameter defaults to 00; other values may return a not-found error if the product isn't offered under that group.
Category Tree
get_categories requires no inputs and returns the full navigation hierarchy for the US store, organized under Women, Men, and Kids & Baby. Each top-level category includes its subcategories and navigation URL paths, making it straightforward to map the store structure or drive a category-filtered browsing experience against list_products.
Coverage Notes
All endpoints reflect the Uniqlo US storefront specifically (uniqlo.com/us/en). Pricing is returned in USD. Inventory status is available at the listing level via list_products, but per-size, per-color stock counts are not part of the current response schema.
The Uniqlo API is a managed, monitored endpoint for uniqlo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when uniqlo.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official uniqlo.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track regular vs. sale price changes across the Uniqlo US catalog using
base_priceand sale price fields fromlist_products - Build a size-availability monitor that checks the
sizesarray fromget_product_detailsfor specific SKUs - Power a category-driven product browser by combining
get_categoriesnavigation paths withlist_productssection filters - Index Uniqlo product images and color variants from
sub_imagesandcolorsarrays for a fashion lookbook app - Search the catalog by keyword using
search_productsand surface results with ratings and pricing in a comparison tool - Extract material composition and care instructions from
get_product_detailsto populate a sustainable-fashion research dataset - Map the full store taxonomy with
get_categoriesto analyze how Uniqlo structures its product hierarchy across departments
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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 that `list_products` does not?+
list_products returns a lightweight summary: title, base price, sale price, availability, image URL, and product page URL. get_product_details adds material composition, care instructions, color-specific sub-images, a full sizes array with codes and names, breadcrumb navigation (gender, class, category, subcategory), and a fit rating score.Can I filter `search_products` or `list_products` by price range or specific size?+
section (women, men, kids, baby) and pagination via offset and limit. You can fork this API on Parse and revise it to add a price-range or size filter endpoint.Does this API cover Uniqlo stores outside the United States?+
How does pagination work across endpoints, and is there a maximum page size?+
offset (starting at 0) and limit (max 100) parameters on search_products and list_products. Each response includes a total field with the full match count and an offset field confirming the current position, so you can calculate the number of remaining pages. get_categories and get_product_details are single-item/single-response calls with no pagination.