--- title: "Uniqlo API: JSON data, 3 endpoints, 1 credit per call" description: "Uniqlo API for product search by colour, size and price, product details and in-store stock near a location, for the US and Japan, as JSON. 1 credit per call." url: https://perceptlayer.com/apis/uniqlo --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Uniqlo 1 credit per call 3 endpoints 12 datapoints # Uniqlo API Uniqlo API for product search by colour, size and price, product details and in-store stock near a location, for the US and Japan, as JSON. 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Uniqlo GET /v1/uniqlo/search?query=jeans ``` { "success": true, "data": { "query": "jeans", "region": "us", "page": 1, "page_size": 36, "sort": "RELEVANCE", "total": 71, "total_pages": 2, "items": [ { "product_id": "E479000-000", "price_group": "00", "name": "Barrel Jeans", "gender": "unisex", "url": "https://www.uniqlo.com/us/en/products/E479000-000/00", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_04_479000_3x4.jpg", "price": { "amount": 49.9, "currency": "USD", "on_sale": false }, "rating": { "average": 4.7, "count": 603 }, "colors": [ { "code": "COL04", "display_code": "04", "name": "GRAY", "color_group": "GRAY", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/479000/chip/goods_04_479000_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_04_479000_3x4.jpg" }, { "code": "COL08", "display_code": "08", "name": "DARK GRAY", "color_group": "GRAY", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/479000/chip/goods_08_479000_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_08_479000_3x4.jpg" }, { "code": "COL67", "display_code": "67", "name": "BLUE", "color_group": "BLUE", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/479000/chip/goods_67_479000_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods_67_479000_3x4.jpg" } ], "sizes": [ { "code": "INS022", "name": "22inch" }, { "code": "INS023", "name": "23inch" }, { "code": "INS024", "name": "24inch" } ], "tags": [ "UNISEX" ], "store_stock_only": false }, { "product_id": "E487206-000", "price_group": "00", "name": "Straight Jeans", "gender": "men", "url": "https://www.uniqlo.com/us/en/products/E487206-000/00", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/487206/item/usgoods_03_487206_3x4.jpg", "price": { "amount": 59.9, "currency": "USD", "on_sale": false }, "rating": { "average": 4.7, "count": 30 }, "colors": [ { "code": "COL03", "display_code": "03", "name": "GRAY", "color_group": "GRAY", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487206/chip/goods_03_487206_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/487206/item/usgoods_03_487206_3x4.jpg" }, { "code": "COL01", "display_code": "01", "name": "OFF WHITE", "color_group": "WHITE", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487206/chip/goods_01_487206_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/487206/item/usgoods_01_487206_3x4.jpg" }, { "code": "COL07", "display_code": "07", "name": "GRAY", "color_group": "GRAY", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487206/chip/goods_07_487206_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/487206/item/usgoods_07_487206_3x4.jpg" } ], "sizes": [ { "code": "INS027", "name": "27inch" }, { "code": "INS028", "name": "28inch" }, { "code": "INS029", "name": "29inch" } ], "tags": [ "Arriving early Dec" ], "store_stock_only": false }, { "product_id": "E488743-000", "price_group": "00", "name": "Barrel Jeans", "gender": "unisex", "url": "https://www.uniqlo.com/us/en/products/E488743-000/00", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/488743/item/usgoods_09_488743_3x4.jpg", "price": { "amount": 59.9, "currency": "USD", "on_sale": false }, "rating": { "average": 4.8, "count": 72 }, "colors": [ { "code": "COL09", "display_code": "09", "name": "BLACK", "color_group": "BLACK", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/488743/chip/goods_09_488743_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/488743/item/usgoods_09_488743_3x4.jpg" }, { "code": "COL57", "display_code": "57", "name": "OLIVE", "color_group": "GREEN", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/488743/chip/goods_57_488743_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/488743/item/usgoods_57_488743_3x4.jpg" }, { "code": "COL69", "display_code": "69", "name": "NAVY", "color_group": "BLUE", "swatch_url": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/488743/chip/goods_69_488743_chip.jpg", "image_url": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/488743/item/usgoods_69_488743_3x4.jpg" } ], "sizes": [ { "code": "INS027", "name": "27inch" }, { "code": "INS028", "name": "28inch" }, { "code": "INS029", "name": "29inch" } ], "tags": [ "UNISEX" ], "store_stock_only": false } ] }, "meta": { "endpoint_family": "search", "request_id": "req_a7edf477aadf40f9aba22bb9e52909b7", "credits_charged": 1, "credits_remaining": 1924 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | product\_id string | price\_group string | name string | gender string | url url | image\_url url | price object | rating object | colors object\[\] | sizes object\[\] | tags string\[\] | store\_stock\_only boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | E479000-000 | 00 | Barrel Jeans | unisex | https://www.uniqlo.com/us/en/products/E479000-000/00 | https://image.uniqlo.com/UQ/ST3/us/imagesgoods/479000/item/usgoods\_04\_479000\_3x4.jpg | {3 fields} | {2 fields} | \[3 items\] | \[3 items\] | \[1 item\] | false | | 2 | E487206-000 | 00 | Straight Jeans | men | https://www.uniqlo.com/us/en/products/E487206-000/00 | https://image.uniqlo.com/UQ/ST3/us/imagesgoods/487206/item/usgoods\_03\_487206\_3x4.jpg | {3 fields} | {2 fields} | \[3 items\] | \[3 items\] | \[1 item\] | false | | 3 | E488743-000 | 00 | Barrel Jeans | unisex | https://www.uniqlo.com/us/en/products/E488743-000/00 | https://image.uniqlo.com/UQ/ST3/us/imagesgoods/488743/item/usgoods\_09\_488743\_3x4.jpg | {3 fields} | {2 fields} | \[3 items\] | \[3 items\] | \[1 item\] | false | Recorded from our API · 3 items shown · 12 datapoints per item GET /v1/uniqlo/search?query=jeans 12 datapoints ### Identity - product\_id string - name string ### Contact - url url - image\_url url ### Reputation - rating object ### Price - price\_group string - price object ### Other - gender string - colors object\[\] - sizes object\[\] - tags string\[\] - store\_stock\_only boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/uniqlo/search?query=jeans" \ -H "X-API-Key: $API_KEY" ``` Uniqlo · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/uniqlo/product`](https://perceptlayer.com/apis/uniqlo/product) | none +4 optional | 1 credit | | [GET `/v1/uniqlo/search`](https://perceptlayer.com/apis/uniqlo/search) | `query` +8 optional | 1 credit | | [GET `/v1/uniqlo/store-stock`](https://perceptlayer.com/apis/uniqlo/store-stock) | none +11 optional | 1 credit | Overview ## About the Uniqlo API ## What you can get The Uniqlo API returns Uniqlo shop data as JSON through 3 endpoints. Each takes a `region` (us or jp). - **Search:** `search` takes a `query`, with `page`, `sort` (RELEVANCE, PRICE\_LOW\_TO\_HIGH, PRICE\_HIGH\_TO\_LOW or RATING), `category`, `colorCodes`, `sizeCodes`, `flagCodes` and `priceRanges`. - **Products:** `product` takes an `id` or a product `url`, with `price_group`. - **Store stock:** `store-stock` takes an `id` or a product `url`, with `price_group`, `l2_id`, `color` and `size`; find stores with `keyword`, or `lat` and `lon`, and cap them with `limit`. The recorded search for "jeans" in us returns `items`, each with `product_id`, `price_group`, `name`, `gender`, `url`, `image_url`, `price` ( `amount`, `currency` and `on_sale`), `rating` ( `average` and `count`), `colors`, `sizes`, `tags` and `store_stock_only`. It also returns `total` (71 in that recording) and `total_pages`. ## How a call works Search, then check stock: `GET /v1/uniqlo/search?query=jeans` with your key in the `X-API-Key` header. Each result carries a `product_id` and `price_group`; `product` and `store-stock` take them as `id` and `price_group`. Add `color`, `size` and a `keyword` to `store-stock` to see one variant's stock in nearby stores. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track Uniqlo prices and sale items for a product list `Use the Uniqlo API to track Uniqlo prices and sale items for a product list` ### Check whether a size and colour is in stock at stores near a customer `Use the Uniqlo API to check whether a size and colour is in stock at stores near a customer` ### Compare product prices between the US and Japan `Use the Uniqlo API to compare product prices between the US and Japan` ### Flag products marked \`store\_stock\_only\` in search results `` Use the Uniqlo API to flag products marked `store_stock_only` in search results `` FAQ ## Questions **How much does the Uniqlo API cost?** Each successful call costs one credit, including \`store-stock\`. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I check stock in a physical store?** Yes. \`store-stock\` takes a product with \`color\` and \`size\`, and finds stores by \`keyword\` or by \`lat\` and \`lon\`. **Which Uniqlo regions are covered?** The US and Japan, set with \`region\` as us or jp. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build an Uniqlo scraper instead?** You can, but an Uniqlo scraper is code you maintain: page changes break it, requests get blocked, and Uniqlo's terms govern how you collect data. The Uniqlo API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Uniqlo API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)