APIs / Uniqlo / Search

Uniqlo: Search

Search from Uniqlo as JSON. 1 credit per successful call.

GET /v1/uniqlo/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
querystringRequiredUp to 100 characters
pageintegerOptionalAny
regionstringOptionalus, jp
colorCodesstringOptionalUp to 200 characters
sizeCodesstringOptionalUp to 200 characters
flagCodesstringOptionalUp to 200 characters
priceRangesstringOptionalAny
categorystringOptionalAny
sortstringOptionalRELEVANCE, PRICE_LOW_TO_HIGH, PRICE_HIGH_TO_LOW, RATING

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.