# Yoox — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse YOOX's fashion catalog to discover products by category, designer, new arrivals, and sale items. Get detailed product information to find exactly what you're looking for across the YOOX marketplace.

**Category:** E-commerce | **Website:** [yoox.com/](https://yoox.com/) | **Docs:** [parse.bot/marketplace/9a88c27f-1654-4db1-acdb-dfd45639dd23/yoox-com-api](https://parse.bot/marketplace/9a88c27f-1654-4db1-acdb-dfd45639dd23/yoox-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieve the navigation category tree for a department. Returns grouped categories (e.g. Clothing, Shoes, Accessories) with names and relative URLs. Useful for discovering browsable sections within a department.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `department` | string | No | Department to get categories for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"department":"<string>"}'
```

### get_designers_list

List all designers (brands) available in a department. Each designer has a display name and an ID suitable for use as the brand filter in search_products. Sorted alphabetically by name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `department` | string | No | Department to get designers for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_designers_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"department":"<string>"}'
```

### get_new_arrivals

Get recently added products for a gender. Paginates via zero-based page number. Returns the same product shape as search_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender for new arrivals. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gender":"<string>","limit":"<integer>","page":"<integer>"}'
```

### get_product_detail

Fetch full details for a single product by its item code. Returns pricing, sizing, composition, images, and other attributes. The item_code is obtained from search_products or get_product_listing_by_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_code` | string | Yes | The unique YOOX item code (e.g. '32047896TE'). Obtain from search_products or get_product_listing_by_category results[*].product_id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_code":"<string>"}'
```

### get_product_listing_by_category

Browse products within a department with optional category keyword filter. Paginates via zero-based page number. Returns the same product shape as search_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Optional category keyword to filter within the department (e.g. 'shoes', 'dresses', 'jackets'). |
| `department` | string | Yes | Department to browse. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_product_listing_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","department":"<string>","limit":"<integer>","page":"<integer>"}'
```

### get_sale_items

Get discounted products for a gender. Paginates via zero-based page number. Returns the same product shape as search_products. All returned items have a non-null discount_percentage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender for sale items. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/get_sale_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gender":"<string>","limit":"<integer>","page":"<integer>"}'
```

### search_products

Full-text search across the YOOX catalog. Supports price range filters, brand filtering, and sort order. Paginates via zero-based page number. Each product includes pricing (current, original, retail), available sizes, images, composition, and color.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Brand ID to filter by (e.g. 'FERRAGAMO-753'). Obtain from get_designers_list results. |
| `limit` | integer | No | Number of results per page. |
| `max_price` | number | No | Maximum price filter in USD. |
| `min_price` | number | No | Minimum price filter in USD. |
| `page` | integer | No | Zero-based page number. |
| `query` | string | Yes | Search keyword (e.g. 'shoes', 'dresses', 'jacket'). |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yoox-com-api-9a88c27f/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","limit":"<integer>","max_price":"<number>","min_price":"<number>","page":"<integer>","query":"<string>","sort_by":"<string>"}'
```