---
title: "Uniqlo API: Search | Perceptlayer"
description: "Search from Uniqlo as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/uniqlo/search
---

[APIs](https://perceptlayer.com/apis) / [Uniqlo](https://perceptlayer.com/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.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | Required | Up to 100 characters |
| `page` | integer | Optional | Any |
| `region` | string | Optional | us, jp |
| `colorCodes` | string | Optional | Up to 200 characters |
| `sizeCodes` | string | Optional | Up to 200 characters |
| `flagCodes` | string | Optional | Up to 200 characters |
| `priceRanges` | string | Optional | Any |
| `category` | string | Optional | Any |
| `sort` | string | Optional | RELEVANCE, 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/uniqlo?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
