Uniqlo
Uniqlo Search API
Search Uniqlo's catalogue by keyword in the US, Japan or South Korea, in the market's language and currency: each item with its product id, 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, up to 100 a page with the total, sorted five ways and filtered by gender, category, flag, colour, size and price range, with facets and related keywords. Also Uniqlo's Greater China sites (Taiwan, Hong Kong, China) in Chinese. 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/jsonquerystringrequiredSearch keywords, 1-200 characters, in the market's language (Chinese on tw, hk and cn: English keywords mostly find nothing there).
Example: heattech
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, plus tw, hk and cn (Uniqlo's Greater China catalogue, in Chinese, with its own product codes and a smaller set of filters); search is not served on the other uniqlo.com storefronts (400, not charged): use product and prices there. 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).tw— Taiwan (Greater China site), TWD, zh-Hant (Traditional Chinese).hk— Hong Kong (Greater China site), HKD, zh-Hant (Traditional Chinese).cn— China (Greater China site), CNY, zh-Hans (Simplified Chinese).
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 (1 to 48 on tw, hk and cn).
Example: 48
sortenum<string>default:featuredResult order. top_rated is offered on us, jp and kr, best_selling on tw, hk and cn.
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).best_selling— Best selling first (tw, hk, cn).
genderenum<string>Only one gender department (default: every department).
Example: women
women— Women.men— Men.kids— Kids.baby— Baby.
category_pathstring | string[]1 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
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.
colorstringColour code from facets.colors (e.g. COL09) or its 2-digit display code (09).
Example: COL09
sizestringSize code from facets.sizes (e.g. SMA004 = M, INS030 = 30 inch).
Example: SMA004
price_minnumberLowest price, in the market's currency.
Example: 10
price_maxnumberHighest price, in the market's currency.
Example: 40
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Women's items on a limited-time offer in the US, cheapest first.
r = client.uniqlo.search(query="jeans", country="us", gender="women", flag="limited_offer", sort="price_asc")["data"]
print(r["total"], "results in", r["currency"])
for i in r["items"]:
print(i["product_id"], i["title"], i["price"], i["limited_offer"])Response