Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Uniqlo

1 credit per call3 endpoints12 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 keyRun 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 OKJSONX-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_idstringprice_groupstringnamestringgenderstringurlurlimage_urlurlpriceobjectratingobjectcolorsobject[]sizesobject[]tagsstring[]store_stock_onlyboolean
1E479000-00000Barrel Jeansunisexhttps://www.uniqlo.com/us/en/products/E479000-000/00https://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
2E487206-00000Straight Jeansmenhttps://www.uniqlo.com/us/en/products/E487206-000/00https://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
3E488743-00000Barrel Jeansunisexhttps://www.uniqlo.com/us/en/products/E488743-000/00https://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 itemGET /v1/uniqlo/search?query=jeans

12 datapoints

Identity

  • product_idstring
  • namestring

Contact

  • urlurl
  • image_urlurl

Reputation

  • ratingobject

Price

  • price_groupstring
  • priceobject

Other

  • genderstring
  • colorsobject[]
  • sizesobject[]
  • tagsstring[]
  • store_stock_onlyboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/uniqlo/product
none+4 optional
1 credit
GET/v1/uniqlo/search
query+8 optional
1 credit
GET/v1/uniqlo/store-stock
none+11 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

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 keyRead the docs