To get Uniqlo prices by market, find the product id once with Scavio's Uniqlo search, then call POST /api/v1/uniqlo/prices with that id and up to 10 countries. Product ids are the same in every market on uniqlo.com, so one call returns each market's price, promo price, sale and limited-offer flags, tax treatment and title in its own currency, for 1 credit per market, in any of 38 markets. Prices compares Uniqlo's regular price list (group 00) unless price_group is sent. Product and stock add colours, sizes and online stock, store stock adds stores near a point, and deals lists each market's limited offers.
A Uniqlo price depends on three things: the product id, the market and the day. Uniqlo sells online in dozens of markets, each with its own currency, tax treatment and sale calendar, and it shows no price history, so anyone comparing or tracking prices has to read each market and keep the readings. Uniqlo publishes no public API for this. Every response below is a trimmed capture from Scavio's Uniqlo API on November 17, 2026, between 18:24 and 19:03 UTC. Prices are numbers in the market's currency: 3990 with "currency": "JPY" is 3,990 yen. Images, notes and long text fields are cut from every sample.
Step 1: Search Uniqlo and get the product id
curl -s https://api.scavio.dev/api/v1/uniqlo/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "jeans", "country": "us"}'The US store returned 71 results. The first:
{
"query": "jeans",
"count": 24,
"total": 71,
"page": 1,
"page_size": 24,
"has_more": true,
"sort": "featured",
"country": "us",
"language": "en",
"currency": "USD",
"items": [
{
"product_id": "E479000-000",
"price_group": "00",
"title": "Barrel Jeans",
"url": "https://www.uniqlo.com/us/en/products/E479000-000/00",
"gender": "unisex",
"price": 39.9,
"promo_price": 39.9,
"currency": "USD",
"discount_percent": null,
"on_sale": true,
"limited_offer": {
"name": "Limited-Time Offer until 11/18",
"start": "2026-11-12T13:00:00.000Z",
"end": "2026-11-19T13:00:00.000Z"
},
"price_flags": [
{
"code": "limitedOffer",
"name": "Limited-Time Offer until 11/18",
"start": "2026-11-12T13:00:00.000Z",
"end": "2026-11-19T13:00:00.000Z"
}
],
"colors": [
{ "code": "COL67", "display_code": "67", "name": "BLUE" },
{ "code": "COL04", "display_code": "04", "name": "GRAY" }
],
"sizes": [
{ "code": "INS028", "name": "28inch" },
{ "code": "INS029", "name": "29inch" }
],
"rating": 4.7,
"review_count": 606,
"store_only": false
}
]
}product_id is the key for every market. Search takes page_size up to 100, sort (featured, newest, price_asc, price_desc, top_rated), gender, category_path, flag (sale, limited_offer, new and more), color, size, price_min and price_max, and returns facets and related keywords. It answers in the US, Japan and Korea, and in Taiwan, Hong Kong and mainland China with Uniqlo's own product codes there. It answered in 5.2 seconds. 1 credit.
Search can list the same id twice. The second entry is price group 01, Uniqlo's "Select Colors/Sizes Only" sale price for some colours or sizes: a heattech search listed the HEATTECH Cashmere Blend Turtleneck (E471601-000) at $29.90 in group 00 and at $19.90 in group 01. Group 00 is Uniqlo's regular price list: product reads it, and prices compares it, unless you send price_group.
Step 2: Read the product
curl -s https://api.scavio.dev/api/v1/uniqlo/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "E479000-000", "country": "us"}'{
"product_id": "E479000-000",
"price_group": "00",
"title": "Barrel Jeans",
"countries_of_origin": ["BD"],
"gender": "unisex",
"price": 39.9,
"promo_price": 39.9,
"currency": "USD",
"discount_percent": null,
"on_sale": true,
"limited_offer": {
"name": "Limited-Time Offer until 11/18",
"start": "2026-11-12T13:00:00.000Z",
"end": "2026-11-19T13:00:00.000Z"
},
"tax": "exclusive",
"rating": {
"average": 4.7,
"count": 607,
"fit": 3.17,
"distribution": { "1": 11, "2": 6, "3": 10, "4": 50, "5": 530 }
},
"review_count": 607,
"best_seller": false,
"variants": [
{
"l2_id": "09463522",
"sku": "487973-04-022-000",
"color": { "code": "COL04", "display_code": "04", "name": "GRAY" },
"size": { "code": "INS022", "display_code": "022", "name": "22inch" },
"price": 39.9,
"promo_price": 39.9,
"on_sale": true
}
],
"country": "us",
"language": "en"
}Product returns the description, composition, care, countries of origin, category, every colour and size, Uniqlo's rating with its fit average, and on the US, Japan and Korea every variant (55 for these jeans) with its l2_id for store stock. tax says whether the price includes tax: exclusive in the US and Canada, inclusive everywhere else we read. To read a colour-limited sale price, pass "price_group": "01": for E471601-000 that returned $19.90 with the flags "Sale" and "Select Colors/Sizes Only". Product answers in 41 markets and returns 404 where a market does not sell the item (charged). It answered in 5.1 seconds. 1 credit.
Step 3: Read the product id in up to 10 markets per call
curl -s https://api.scavio.dev/api/v1/uniqlo/prices \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "E479000-000", "countries": ["jp", "us", "ca", "gb", "de", "kr", "au", "sg", "th", "in"]}'{
"product_id": "E479000-000",
"price_group": "00",
"markets": [
{
"country": "jp",
"language": "ja",
"currency": "JPY",
"available": true,
"title": "バギーバレルレッグジーンズ",
"product_id": "E479000-000",
"price": 3990,
"promo_price": 3990,
"discount_percent": null,
"on_sale": true,
"limited_offer": {
"name": "11/19まで期間限定価格",
"start": "2026-11-12T17:00:00.000Z",
"end": "2026-11-19T17:00:00.000Z"
},
"tax": "inclusive",
"url": "https://www.uniqlo.com/jp/ja/products/E479000-000/00"
},
{
"country": "ca",
"language": "en",
"currency": "CAD",
"available": true,
"title": "Barrel Jeans",
"product_id": "E479000-000",
"price": 59.9,
"promo_price": null,
"discount_percent": null,
"on_sale": false,
"limited_offer": null,
"price_flags": [],
"tax": "exclusive",
"url": "https://www.uniqlo.com/ca/en/products/E479000-000/00"
},
{
"country": "sg",
"language": "en",
"currency": "SGD",
"available": false,
"title": null,
"product_id": null,
"price": null,
"promo_price": null
}
],
"not_sold": ["sg"],
"errors": [],
"count": 10
}All 10 markets answered (3 shown) in 23.7 seconds, 10 credits, the not-sold Singapore included. A market that fails is listed in errors and not charged. The UK is gb (uk works too). A second call with ["my", "ph", "id", "vn", "se", "dk", "ie"] read 7 more markets for 7 credits; ie and 16 other EU countries are served by Uniqlo's EU store, in euros and English. The Barrel Jeans on November 17, with euros at the ECB rates of that day:
| Market | Listed price | Flag | In EUR |
|---|---|---|---|
| Philippines | PHP 1,990, promo PHP 1,490 | Limited Offer from 12 Nov - 19 Nov 2026 | €21.29 |
| Japan | JPY 3,990 | 11/19まで期間限定価格 (until 11/19) | €22.79 |
| Malaysia | MYR 149.90 | €33.32 | |
| India | INR 3,490 | €33.98 | |
| Thailand | THB 1,290 | €34.69 | |
| United States | $39.90 (before sales tax) | Limited-Time Offer until 11/18 | €36.31 |
| Australia | AUD 59.90 | €36.71 | |
| Canada | CAD 59.90 (before sales tax) | €38.14 | |
| South Korea | KRW 59,900 | €40.79 | |
| United Kingdom | £39.90 | €47.90 | |
| Germany, EU store (Ireland) | €49.90 | €49.90 | |
| Denmark | DKK 399 | €53.38 | |
| Sweden | SEK 599 | €53.92 | |
| Singapore, Indonesia, Vietnam | not sold |
A limited offer is per market: on November 17 the Barrel Jeans had one in Japan, the US and the Philippines, and in none of the other 11 markets that sold them. In the Philippines it shows as a promo_price below price; in Japan and the US it is a flag on the listed price, so the regular price is not in that day's answer. In Python, one id across every market you list:
import requests
API = "https://api.scavio.dev/api/v1/uniqlo"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
MARKETS = ["jp", "us", "ca", "gb", "de", "kr", "au", "sg", "th", "in",
"my", "ph", "id", "vn", "se", "dk", "ie"]
product_id = "E479000-000"
for i in range(0, len(MARKETS), 10): # up to 10 markets per call, 1 credit per market
d = requests.post(f"{API}/prices", headers=HEADERS, timeout=180,
json={"product_id": product_id, "countries": MARKETS[i:i + 10]}).json()["data"]
for m in d["markets"]:
if m["available"]:
flags = [f["name"] for f in m["price_flags"]]
print(m["country"], m["currency"], m["price"], m["promo_price"], m["tax"], flags)
print("not sold:", d["not_sold"])Step 4: Convert with one dated exchange rate
The API never converts. Pick one dated reference rate and say which; we used the ECB euro reference rates of November 17, 2026. The ECB publishes no rate for the Vietnamese dong, so Vietnam needs another dated source or stays in dong.
import re, urllib.request
xml = urllib.request.urlopen("https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml").read().decode()
date = re.search(r"time='([\d-]+)'", xml).group(1)
per_eur = {c: float(r) for c, r in re.findall(r"currency='(\w+)' rate='([\d.]+)'", xml)}
per_eur["EUR"] = 1.0
def to_eur(amount, currency):
return amount / per_eur[currency]
print(date, round(to_eur(3990, "JPY"), 2)) # 2026-11-17 22.79Decide which price you compare. For what a shopper sees, use promo_price where it is set and price otherwise. For a regular-price comparison, drop items with on_sale true in the markets you compare, because on the US, Japan, Korea and Canada stores the listed price of a flagged item already is the sale price. US and Canadian prices exclude sales tax; the other markets we read include tax.
Step 5: Check online stock by size
curl -s https://api.scavio.dev/api/v1/uniqlo/stock \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "E479000-000", "country": "us"}'{
"product_id": "E479000-000",
"price_group": "00",
"title": "Barrel Jeans",
"variants": [
{
"l2_id": "09463528",
"sku": "487973-04-028-000",
"color": { "code": "COL04", "display_code": "04", "name": "GRAY" },
"size": { "code": "INS028", "display_code": "028", "name": "28inch" },
"price": 39.9,
"promo_price": 39.9,
"on_sale": true,
"sold_online": true,
"status": "in_stock",
"status_raw": "IN_STOCK",
"quantity": 11,
"quantity_capped": true,
"back_in_stock": false,
"in_transit": false
},
{
"l2_id": "09463533",
"sku": "487973-04-034-000",
"color": { "code": "COL04", "display_code": "04", "name": "GRAY" },
"size": { "code": "INS034", "display_code": "034", "name": "34inch" },
"status": "out_of_stock",
"status_raw": "STOCK_OUT",
"quantity": 0,
"quantity_capped": false,
"back_in_stock": true
}
],
"variants_total": 55,
"variants_in_stock": 40,
"country": "us",
"currency": "USD"
}40 of the 55 colour and size variants were in stock online in the US; every navy one was out. status is Uniqlo's own (in_stock, low_stock, out_of_stock), and Uniqlo caps the quantity it shows at 11, so quantity_capped: true means 11 or more. Across 5 popular items, 87.9% of the US variants and 80.4% of the Japanese ones were in stock. The sku prefix is not the product id. Stock answers in the US, Japan and Korea. It answered in 6.3 seconds. 1 credit.
Step 6: Check store stock near a point
curl -s https://api.scavio.dev/api/v1/uniqlo/store-stock \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "E479000-000", "price_group": "00", "color": "COL04", "size": "INS028", "lat": 40.758, "lng": -73.9855, "country": "us"}'Store stock returns one variant's status in the 10 Uniqlo stores nearest a point: per store store_code, name, distance_km, status (in_stock, low_stock or out_of_stock as Uniqlo states it), store_status and order_and_pick, plus stores_with_stock and total_stores. It is a status per store, not a unit count. It takes an l2_id from stock or product (1 credit), or a product_id with color and size codes (2 credits, a variant lookup first). Pass the price_group the variant came from (00 here, the product's regular price list, which is also the default): a variant of price group 01, Uniqlo's "Select Colors/Sizes Only" sale price, asked as 00 reads out of stock in every store. Stores lists every store with address, hours and services. US, Japan and Korea.
Step 7: List each market's limited offers
curl -s https://api.scavio.dev/api/v1/uniqlo/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "limited_offer", "country": "us", "page_size": 100}'{
"type": "limited_offer",
"gender": null,
"count": 62,
"total": 62,
"page": 1,
"page_size": 100,
"has_more": false,
"sort": "featured",
"country": "us",
"currency": "USD",
"items": [
{
"product_id": "E494100-000",
"price_group": "00",
"title": "Baggy Barrel Jeans",
"gender": "women",
"price": 39.9,
"promo_price": 39.9,
"on_sale": true,
"limited_offer": {
"name": "Limited-Time Offer until 11/18",
"start": "2026-11-12T13:00:00.000Z",
"end": "2026-11-19T13:00:00.000Z"
},
"rating": 5,
"review_count": 6
}
]
}On November 17 the US listed 62 limited offers, Japan 49 and Korea 20, and every offer in a market carried the same Uniqlo label: "Limited-Time Offer until 11/18" in the US, "11/19まで期間限定価格" (until 11/19) in Japan and "2026/11/13부터 2026/11/19까지 기간한정가격" (November 13 to 19) in Korea. "type": "sale" reads the sale list instead: 384 items in the US, 389 in Japan and 419 in Korea. On these three stores the listed price of every deal item equals its promo_price, so a single reading cannot tell you how deep a limited offer is; read the same id again after its window closes. Sale flags carry a start date and no end; the "Select Colors/Sizes Only" flag carries no dates. Uniqlo's own listings can include collaboration items from GU, Uniqlo's sister brand, as Korea's limited offers did; GU is not a separate platform here. 1 credit per page.
Step 8: Read reviews with fit
Reviews ({"product_id": "E479000-000", "country": "us", "page_size": 25}) returns up to 25 reviews per page (page_size), newest first, with rating, title, text, created_at, fit from 1 (tight) to 5 (loose) with fit_label, and purchased_size, without reviewer names or locations. The Barrel Jeans had 607 US reviews, an average of 4.7 and a fit average of 3.17; 39 of the 50 newest said true to size. Across the 250 newest US reviews of 5 popular items, 89.2% gave fit 3, and the fit averages ran from 2.90 (HEATTECH T-shirt) to 3.19. 1 credit.
Step 9: Poll daily through Black Friday and keep your own history
Black Friday is Friday, November 27, 2026; Uniqlo had announced no dates in anything we captured, and BlackFriday.com predicts its sale will likely start the day before. Nothing in a response tells you yesterday's price, and on the US, Japan, Korea and Canada stores the depth of a sale shows up when you compare readings, so store every reading:
import csv, datetime, requests
API = "https://api.scavio.dev/api/v1/uniqlo"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
PRODUCT_IDS = ["E479000-000", "E469742-000", "E422992-000", "E450543-000", "E449753-000"] # your list
MARKETS = ["jp", "us", "ca", "gb", "de", "kr", "au", "sg", "th", "ie"] # one prices call
STOCK_MARKETS = ["us", "jp"] # sizes where you need them
def post(path, body):
r = requests.post(f"{API}/{path}", headers=HEADERS, json=body, timeout=180)
return r.json()["data"] if r.status_code == 200 else None # failed calls are not charged
now = datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="seconds")
with open("uniqlo_prices.csv", "a", newline="") as f:
w = csv.writer(f)
for pid in PRODUCT_IDS: # one request at a time
d = post("prices", {"product_id": pid, "countries": MARKETS}) # 1 credit per market
if not d:
continue
for m in d["markets"]:
if not m["available"]:
continue
offer = m["limited_offer"] or {}
sizes = {"in_stock": None, "low_stock": None, "out_of_stock": None}
if m["country"] in STOCK_MARKETS:
s = post("stock", {"product_id": pid, "country": m["country"]}) # 1 credit
if s:
states = [v["status"] for v in s["variants"]]
sizes = {k: states.count(k) for k in sizes}
w.writerow([pid, m["country"], m["currency"], now, m["price"], m["promo_price"], m["on_sale"],
offer.get("name"), m["tax"], sizes["in_stock"], sizes["low_stock"], sizes["out_of_stock"]])The columns are product_id, market, currency, captured_at, price, promo_price, on_sale, limited_offer label, tax, variants_in_stock, variants_low and variants_out. Run it once a day from November 26 to November 30 (cron or any scheduler). With 5 items in these 10 markets, a reading is 50 credits for prices plus 10 for stock, 60 credits a day and 300 for the five days: $0.30 on the Growth plan of $1 per 1,000 credits.
What it costs per product per day: 1 credit per market with prices, so one item in 10 markets is 10 credits ($0.01) a day, and 1,000 items in 10 markets are 10,000 credits ($10.00) a day; add 1 credit per item per market for online stock by size. If your items are whole lists, deals, category and new arrivals list up to 100 items with prices and flags per call in the US, Japan or Korea, so the US limited-offer list is 1 credit a day.
All Uniqlo endpoints
| Endpoint | What it returns | Markets | Credits |
|---|---|---|---|
| search | Keyword search with prices, flags, colours, sizes, facets | us, jp, kr; tw, hk, cn with Uniqlo's own codes | 1 |
| product | One product with composition, colours, sizes, rating with fit; variants on us, jp, kr | 41 | 1 |
| prices | One product id in up to 10 markets: price, promo price, flags, tax | 38 | 1 per market that answered |
| stock | Online stock per colour and size, quantity capped at 11 | us, jp, kr | 1 |
| store-stock | One variant's status in the 10 nearest stores | us, jp, kr | 1 by l2_id, 2 by product id, colour and size |
| stores | Stores near a point or by id, with hours and services | us, jp, kr | 1 |
| reviews | Reviews with rating, text, fit and purchased size | us, jp, kr | 1 |
| deals | The sale or limited-offer list | us, jp, kr | 1 |
| new-arrivals | Items Uniqlo flags new | us, jp, kr | 1 |
| category | Every product of one category path | us, jp, kr | 1 |
| categories | A market's category tree | us, jp, kr | 1 |
| suggestions | Search suggestions, or trending words with no query | us, jp, kr | 1 |
The 38 prices markets are the US, Japan and Korea; Australia, Belgium, Canada, Denmark, France, Germany, India, Indonesia, Italy, Malaysia, the Netherlands, the Philippines, Singapore, Spain, Sweden, Thailand, the UK and Vietnam; and Uniqlo's EU store for Austria, Bulgaria, Croatia, the Czech Republic, Estonia, Finland, Greece, Hungary, Ireland, Latvia, Lithuania, Luxembourg, Poland, Portugal, Romania, Slovakia and Slovenia. Countries where Uniqlo has no online store (Switzerland, Norway, New Zealand, Mexico, Turkey, the UAE, Israel and Russia) answer 400 before anything is charged. Not available: price history, store-level prices, and GU as a separate catalogue.
Getting started
- Sign up and copy your API key; you get 50 free credits, no card.
- Run Step 1 with your own query, or try search, prices and stock in the playground.
- Save the product ids you care about; they work in every market that sells the item.
- Read them with prices in each market you need, once a day, and store the rows.
- Agents can call the same endpoints through the MCP server.
Try the Uniqlo API free: 50 credits read one product id in 38 markets.
Reference: Uniqlo API overview · prices docs · search docs · product docs · store stock docs · best Uniqlo Japan price APIs · is Uniqlo cheaper in Japan? · how to get Zara prices by country · how to get H&M prices by country
Frequently asked questions
Is the Uniqlo product id the same in every country?
On uniqlo.com, yes. The id in a product link, for example E479000-000 for the Barrel Jeans, opens the same product in every market that sells it, with the title in that market's language. A market that does not sell the item returns it as not sold. Uniqlo's Greater China sites (Taiwan, Hong Kong, mainland China) use their own product codes.
Why does a Uniqlo sale price equal the regular price in the API?
On the US, Japan, Korea and Canada stores, and on some items in Singapore, Malaysia and India, Uniqlo marks a drop with flags only, so promo_price equals price and the listed price already is the sale price. In Europe, Australia and most of Southeast Asia promo_price is below price. Read on_sale, limited_offer and price_flags, which carry Uniqlo's own label, such as Limited-Time Offer until 11/18.
Is it cheaper to buy Uniqlo online or in store?
Scavio's Uniqlo API returns online prices, so it cannot answer that from one reading: store stock tells you whether a store near a point has a size, not what the store charges. Online, the Barrel Jeans were $39.90 in the US on November 17, 2026, on a limited offer Uniqlo labelled Limited-Time Offer until 11/18.
When does Uniqlo Black Friday 2026 start?
Uniqlo had not announced Black Friday 2026 dates in anything we captured by November 17. Black Friday is Friday, November 27, 2026, and BlackFriday.com predicts the sale will likely start the day before and run to Cyber Monday, which is a deal site's reading of past years, not Uniqlo's word. Polling prices daily from November 26 to November 30 shows what each market changes.
What do Uniqlo's terms say?
Scavio does not collect or store Uniqlo data: each call fetches the public Uniqlo page at the moment your request asks for it and returns what it shows as JSON, with no response cache. Uniqlo's terms of use cover how its website and content may be used; read the current terms for your market and use case and get your own advice. This is not legal advice.