Uniqlo
Uniqlo Deals API
Uniqlo's sale items or limited-time offers in the US, Japan or South Korea, for every department or one gender: items with price, promotional price, the offer flags (a limited-time offer with Uniqlo's own label, e.g. "Limited-Time Offer until 11/18", and its window; a sale flag with a start but no end), colours, sizes, rating and review count, paged up to 100 at a time with the total, sorted five ways, with facets. 62 items carried a limited-time offer 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/jsontypeenum<string>default:saleWhich list to read.
Example: limited_offer
sale— Items Uniqlo flags Sale. The default.limited_offer— Items Uniqlo flags Limited-Time Offer.
genderenum<string>Only one gender department (default: every department).
Example: women
women— Women.men— Men.kids— Kids.baby— Baby.
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).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# This week's limited-time offers in the US, with Uniqlo's own label (e.g. "Limited-Time Offer until 11/18").
r = client.uniqlo.deals(type="limited_offer", country="us", page_size=100)["data"]
print(r["total"], "items on a limited-time offer")
for i in r["items"]:
print(i["product_id"], i["title"], i["price"], i["limited_offer"]["name"] if i["limited_offer"] else None)Response