# Categories list

List the flattened Uniqlo France taxonomy: genders, classes, and categories with parent chains and ready-to-use product paths.

- Platform: [Uniqlo](https://docs.upscrape.com/docs/platforms/uniqlo)
- Capability ID: `uniqlo.categories.list`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {},
  "capability": "uniqlo.categories.list"
}'
```

## Input


This capability accepts an empty input object.

### Example input

```json
{}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "categories": [
    {
      "id": 85018,
      "key": "t-shirts",
      "name": "T-shirts",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        },
        {
          "id": 84986,
          "key": "tops",
          "name": "T-shirts, Sweats & Polaires"
        }
      ],
      "path": "37608,84986,85018"
    },
    {
      "id": 85023,
      "key": "bra-tops",
      "name": "Tops à brassière intégrée",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        },
        {
          "id": 84986,
          "key": "tops",
          "name": "T-shirts, Sweats & Polaires"
        }
      ],
      "path": "37608,84986,85023"
    },
    {
      "id": 146730,
      "key": "sleeveless-tops",
      "name": "Sans Manches",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        },
        {
          "id": 84986,
          "key": "tops",
          "name": "T-shirts, Sweats & Polaires"
        }
      ],
      "path": "37608,84986,146730"
    }
  ],
  "classes": [
    {
      "id": 84986,
      "key": "tops",
      "name": "T-shirts, Sweats & Polaires",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        }
      ],
      "path": "37608,84986"
    },
    {
      "id": 84987,
      "key": "bottoms",
      "name": "Jeans, Pantalons & Shorts",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        }
      ],
      "path": "37608,84987"
    },
    {
      "id": 100139,
      "key": "shirts-and-blouses",
      "name": "Chemises, Blouses & Polos",
      "parents": [
        {
          "id": 37608,
          "key": "women",
          "name": "WOMEN"
        }
      ],
      "path": "37608,100139"
    }
  ],
  "genders": [
    {
      "gender_key": "women",
      "id": 37608,
      "name": "WOMEN"
    },
    {
      "gender_key": "men",
      "id": 37609,
      "name": "MEN"
    },
    {
      "gender_key": "kids",
      "id": 37610,
      "name": "KIDS"
    }
  ],
  "raw": {
    "result": {
      "categories": [
        {
          "id": 85018,
          "key": "t-shirts",
          "name": "T-shirts",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            },
            {
              "id": 84986,
              "key": "tops",
              "name": "T-shirts, Sweats & Polaires"
            }
          ]
        },
        {
          "id": 85023,
          "key": "bra-tops",
          "name": "Tops à brassière intégrée",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            },
            {
              "id": 84986,
              "key": "tops",
              "name": "T-shirts, Sweats & Polaires"
            }
          ]
        },
        {
          "id": 146730,
          "key": "sleeveless-tops",
          "name": "Sans Manches",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            },
            {
              "id": 84986,
              "key": "tops",
              "name": "T-shirts, Sweats & Polaires"
            }
          ]
        }
      ],
      "classes": [
        {
          "id": 84986,
          "key": "tops",
          "name": "T-shirts, Sweats & Polaires",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            }
          ]
        },
        {
          "id": 84987,
          "key": "bottoms",
          "name": "Jeans, Pantalons & Shorts",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            }
          ]
        },
        {
          "id": 100139,
          "key": "shirts-and-blouses",
          "name": "Chemises, Blouses & Polos",
          "parents": [
            {
              "id": 37608,
              "key": "women",
              "name": "WOMEN"
            }
          ]
        }
      ],
      "genders": [
        {
          "genderKey": "women",
          "id": 37608,
          "name": "WOMEN"
        },
        {
          "genderKey": "men",
          "id": 37609,
          "name": "MEN"
        },
        {
          "genderKey": "kids",
          "id": 37610,
          "name": "KIDS"
        }
      ]
    },
    "status": "ok"
  }
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `categories` | `array` | 3 items |
| `categories` | `array` | 3 items |
| `classes` | `array` | 3 items |
| `classes` | `array` | 3 items |
| `genders` | `array` | 3 items |
| `genders` | `array` | 3 items |
| `raw` | `object` | 2 fields |
| `raw.result` | `object` | 3 fields |
| `raw.status` | `string` | ok |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)