Uniqlo
Uniqlo Product API
One Uniqlo product by product id or link on 41 markets, in the market's language and currency: title, description, composition, care, countries of origin, category path, price, promotional price, sale and limited-time-offer flags (a limited-time offer with Uniqlo's own label and its window), tax, colours, sizes, lengths, the rating with its fit average and star distribution, images, size chart and tags; on the US, Japan and South Korea also every variant (colour x size) with its id for store stock. Product ids are global on uniqlo.com. 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/jsonproduct_idstringA Uniqlo product id (items[].product_id): E + 6 digits + -000 on uniqlo.com, the same in every market; u + 13 digits on tw, hk and cn. Send product_id or url.
Example: E479000-000
urlstringA Uniqlo product link from any market (https://www.uniqlo.com/<country>/<language>/products/<id>/<price group>, or a tw / hk / cn product-detail link). Its market and language are used unless country is sent.
Example: https://www.uniqlo.com/us/en/products/E479000-000/00
price_groupstringdefault:00Price group, 2 digits (items[].price_group of a list answer): default 00 = Uniqlo's regular price list; 01 is mostly the Select Colors/Sizes Only sale price search lists for some colours / sizes.
Example: 00
countrystringdefault:usThe Uniqlo market, as a lowercase ISO-2 code (gb for the United Kingdom; uk works too). This endpoint serves all 41 Uniqlo markets: us, jp and kr, the other uniqlo.com storefronts, Uniqlo's EU store countries and the Greater China sites tw, hk and cn. 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).au— Australia, AUD, en (English).be— Belgium, EUR, nl (Dutch), fr (French), en (English); default nl.ca— Canada, CAD, en (English), fr (French); default en.de— Germany, EUR, de (German), en (English); default de.dk— Denmark, DKK, en (English).es— Spain, EUR, es (Spanish), en (English); default es.fr— France, EUR, fr (French), en (English); default fr.gb— United Kingdom, GBP, en (English).id— Indonesia, IDR, id (Indonesian), en (English); default id.in— India, INR, en (English).it— Italy, EUR, it (Italian), en (English); default it.my— Malaysia, MYR, en (English).nl— Netherlands, EUR, nl (Dutch), en (English); default nl.ph— Philippines, PHP, en (English).se— Sweden, SEK, en (English).sg— Singapore, SGD, en (English).th— Thailand, THB, th (Thai), en (English); default th.vn— Vietnam, VND, vi (Vietnamese), en (English); default vi.at— Austria (EU store), EUR, en (English).bg— Bulgaria (EU store), EUR, en (English).cz— Czechia (EU store), EUR, en (English).ee— Estonia (EU store), EUR, en (English).fi— Finland (EU store), EUR, en (English).gr— Greece (EU store), EUR, en (English).hr— Croatia (EU store), EUR, en (English).hu— Hungary (EU store), EUR, en (English).ie— Ireland (EU store), EUR, en (English).lt— Lithuania (EU store), EUR, en (English).lu— Luxembourg (EU store), EUR, en (English).lv— Latvia (EU store), EUR, en (English).pl— Poland (EU store), EUR, en (English).pt— Portugal (EU store), EUR, en (English).ro— Romania (EU store), EUR, en (English).si— Slovenia (EU store), EUR, en (English).sk— Slovakia (EU store), EUR, en (English).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
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# One product in Germany, in German, priced in euros.
p = client.uniqlo.product(product_id="E471601-000", country="de")["data"]
print(p["title"], p["price"], p["promo_price"], p["currency"], p["tax"])
print(p["composition"], p["countries_of_origin"])
print(p["rating"])Response