Uniqlo
Uniqlo Store Stock API
Stock of one Uniqlo variant (one colour and size) in the stores nearest a point, in the US, Japan or South Korea: per store its code, name, distance, Uniqlo's in-store status (in stock, low stock, out of stock; no unit counts), whether the store is open, order-and-pick and its departments, with the count of stores that have it. Send the variant id from stock or product (1 credit), or product_id + colour + size (2 credits: the variant lookup, then the store stock), with the price group the variant came from (default 00).
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/jsonl2_idstringVariant id, 8 digits (variants[].l2_id of stock or product). Send l2_id or product_id + color + size. 1 credit.
Example: 08665900
product_idstringInstead of l2_id: a product id (E479000-000) with color and size (and length when the product comes in lengths). 2 credits.
Example: E479000-000
price_groupstringdefault:00Price group the variant came from (items[].price_group or product's price_group, default 00), with l2_id or with product_id. A variant of price group 01 asked as 00 reads out of stock in every store.
Example: 00
colorstringWith product_id: colour code (colors[].code of product, e.g. COL67).
Example: COL67
sizestringWith product_id: size code (sizes[].code, e.g. INS029).
Example: INS029
lengthstringWith product_id, when the product comes in lengths: length code (lengths[].code).
Example: SLA020
latnumberrequiredLatitude of a point in the country (40.758 New York, 35.6595 Tokyo, 37.5636 Seoul).
Example: 40.758
lngnumberrequiredLongitude (-73.9855 New York, 139.7005 Tokyo, 126.9826 Seoul).
Example: -73.9855
limitintegerdefault:10Stores, 1 to 10, nearest first.
Example: 5
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
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Is the Barrel Jeans in blue, 29 inch, in a store near Times Square?
# Send the price group the variant came from (00 here, the product's regular price list).
r = client.uniqlo.store_stock(l2_id="08665900", price_group="00", lat=40.758, lng=-73.9855, country="us")["data"]
print(r["stores_with_stock"], "of", r["count"], "stores have it")
for s in r["stores"]:
print(s["name"], s["distance_km"], s["status"])Response