UNIQLO search
UNIQLO product search in 20 country stores: id, name, link, price, promo price, currency, rating, review count, gender, colours, sizes, flags (sale, new, limited offer...), promotion and images by colour, with colour, size, price-band, flag and category filters and sorts. Also the colour, size, price, flag, rating and category facets.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
q | string | Search words (or category). Example: shirt |
country | us | ca | uk | jp | au | sg | in | ph | my | th | vn | id | kr | de | fr | es | it | se | nl | dk | Store country (default us). Example: us |
category | string | Category ids from the facets, comma separated (gender, class, category), e.g. 22211 for men. |
color | string | Colour codes from the facets, comma separated (e.g. COL00). |
size | string | Size codes from the facets, comma separated (e.g. SMA004). |
price | string | Price bands from-to, comma separated (e.g. 20-40; open ends allowed: -10, 80-). |
flag | string | Flags from the facets, comma separated (discount, limitedOffer, salesStart...). |
sort | relevance | price_asc | price_desc | rating | newest | Sort order. Example: price_asc |
limit | integer | Products per page, 1-100 (default 36). Example: 36 |
page | integer | Page number (default 1). next_page is null on the last page. Example: 1 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/uniqlo/v1/search?q=shirt" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/uniqlo/v1/search",
params={"q": "shirt"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/uniqlo/v1/search");
url.searchParams.set("q", "shirt");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).