# Zalando (Italy) — 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.

> Browse and extract product data from Zalando Italy, including search results, category listings, and full product detail pages.

**Category:** E-commerce | **Website:** [zalando.it/](https://zalando.it/) | **Docs:** [parse.bot/marketplace/9dab2f5b-12d4-43d8-993a-e0a9fefb8b88/zalando-it-api](https://parse.bot/marketplace/9dab2f5b-12d4-43d8-993a-e0a9fefb8b88/zalando-it-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-zalando-it-api-9dab2f5b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_listing

Fetches product listings from a Zalando Italy category page with optional maximum price filter. Returns products with name, brand, price, URL, and image. Results are from the first page (typically up to ~48 items).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | No | Category path on Zalando Italy (e.g. '/scarpe-uomo/', '/abbigliamento-uomo/') |
| `price_to` | number | No | Maximum price filter in EUR |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zalando-it-api-9dab2f5b/get_category_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>","price_to":"<number>"}'
```

### get_homepage

Fetches the Zalando Italy men's homepage and extracts promotional/editorial images with their alt text descriptions. Returns the final page URL and all featured images found on the page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zalando-it-api-9dab2f5b/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_detail

Fetches detailed product information from a Zalando Italy product page. Extracts structured data including price, available sizes, color, brand, SKU, and product images from the page's JSON-LD markup. Requires a full product URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full Zalando Italy product URL (e.g. https://www.zalando.it/nike-sportswear-air-force-1-07-sneakers-basse-white-ni112n022-a11.html) |

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

### search_products

Search for products on Zalando Italy by keyword. Returns matching product listings with name, brand, price, URL, and image. Results are from the first page of search results (typically up to ~48 items).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'nike', 'scarpe', 'adidas') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zalando-it-api-9dab2f5b/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```