Uniqlo
Uniqlo Suggestions API
The search suggestions Uniqlo offers for what a shopper has typed, in the US, Japan or South Korea, in the market's language: suggested searches, matching categories with ids you can pass to search or category, and Uniqlo's feature pages. With no query, Uniqlo's trending search words. 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/jsonquerystringWhat the shopper has typed so far, up to 100 characters. Empty or absent: Uniqlo's trending search words.
Example: jea
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)
# What US shoppers are offered after typing "jea", and the categories it maps to.
r = client.uniqlo.suggestions(query="jea", country="us")["data"]
print(r["suggestions"])
for c in r["categories"]:
print(c["id"], c["gender"], c["parent"], c["title"])Response