Uniqlo
Uniqlo Category API
Every product of one Uniqlo category in the US, Japan or South Korea, by its category path (gender, class, category, subcategory ids from categories): items with price, promotional price, sale and limited-time-offer flags (a limited-time offer with Uniqlo's own label and its window), colours, sizes, rating and review count, paged up to 100 at a time with the total, sorted five ways and optionally filtered to one flag, with facets. Women > bottoms > jeans held 30 items in the US on 2026-11-17. Costs 1 credit per request.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncategory_pathstring | string[]required1 to 4 category ids (gender, class, category, subcategory): a node's path from categories, comma-joined or as an array. Ids are per market (22210,23296,23339 is women > bottoms > jeans on us).
Example: 22210,23296,23339
countrystringdefault:usThe Uniqlo market, as a lowercase ISO-2 code (gb for the United Kingdom; uk works too). This endpoint serves us, jp and kr (the three markets where Uniqlo serves this data; every other market answers 400, not charged: on the other uniqlo.com storefronts use product and prices, on tw, hk and cn search and product). Prices come back in the market's own currency, never converted; every answer echoes country, language and currency. ch, no, nz, mx, tr, ae and il (no Uniqlo online store) and ru (closed) answer 400, not charged; uk is accepted for gb.
Example: us
us— United States, USD, en (English). The default.jp— Japan, JPY, ja (Japanese).kr— South Korea, KRW, ko (Korean).
languagestringThe answer's language, from the market's own list (the first is the default; see the markets table): us en, jp ja, kr ko, be nl, fr or en, ca en or fr, de, es, fr, it and nl their language or en, id id or en, th th or en, vn vi or en, tw and hk zh-Hant, cn zh-Hans, en everywhere else. Titles, descriptions, colour and category names come back in it. Danish on dk and Swedish on se are not served (Uniqlo's pages in those languages carry no product data): send en. A language Uniqlo does not offer on a market (us es, jp en, kr en, in hi, my ms) answers 400, not charged.
Example: en
pageintegerdefault:1Results page, 1-based. Uniqlo answers up to offset 500 (page x page_size).
Example: 2
page_sizeintegerdefault:24Items per page, 1 to 100.
Example: 48
sortenum<string>default:featuredResult order.
Example: price_asc
featured— Uniqlo's own order. The default.newest— Newest first.price_asc— Price, low to high.price_desc— Price, high to low.top_rated— Top rated first (us, jp, kr).
flagenum<string>Only items Uniqlo flags this way.
Example: limited_offer
sale— Flagged Sale (Uniqlo code discount).limited_offer— Flagged Limited-Time Offer (limitedOffer).new— Flagged New (salesStart).new_color— Flagged New color (newSKU).coming_soon— Flagged Coming Soon (comingSoon).online_only— Flagged Online only (onlineOnly). jp only; 400 elsewhere.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Women's jeans in the US, with the items on a limited-time offer flagged.
r = client.uniqlo.category(category_path="22210,23296,23339", country="us", page_size=100)["data"]
print(r["total"], "items")
for i in r["items"]:
print(i["product_id"], i["title"], i["price"], i["on_sale"], i["limited_offer"])Response