---
title: "List YOOX categories"
method: GET
path: "/yoox/categories"
tags: ["YOOX"]
---

# List YOOX categories

`GET /yoox/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yoox/categories`
- Auth: API key in header `x-api-key`

Lists YOOX categories grouped by department (`women`, `men` and `kids`), each with its name, slug and URL. Every category slug is valid as `category` in YOOX search. Calls can take up to about 80 seconds, and a call that cannot finish, or one made while YOOX shows its maintenance page, returns `503`.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YooxCategoriesDoc
  - `code` integer
  - `data` YooxCategoriesResponse
    - `departments` YooxDepartmentCategories[]
      - `categories` YooxCategory[]
        - `name` string
        - `slug` string
        - `url` string
      - `department` string
  - `msg` string

## Other responses

- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)