# Zara — 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.

> Shop Zara's entire catalog by browsing categories, searching for specific items, and viewing detailed product information including measurements and related products. Find nearby store locations, check real-time inventory availability, and get shipping details all in one place.

**Category:** E-commerce | **Website:** [zara.com/](https://zara.com/) | **Docs:** [parse.bot/marketplace/24e127dd-563b-4210-8ce8-76a9eb30954e/zara-com-api](https://parse.bot/marketplace/24e127dd-563b-4210-8ce8-76a9eb30954e/zara-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-zara-com-api-24e127dd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_store_availability

Checks stock availability in physical stores.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `reference` | string | Yes | Product reference (e.g. 0250704150002-V2026) |
| `section` | string | No | Section name |
| `store_ids` | string | Yes | Comma-separated store IDs (e.g. 3904,3862) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/check_store_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference":"<string>","section":"<string>","store_ids":"<string>"}'
```

### get_categories

Returns all top-level and sub-level product categories available on Zara US. Categories include section names (WOMAN, MAN, KIDS) and nested subcategories with SEO metadata. Each category has an ID that can be used with get_category_products to fetch products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_category_products

Returns products for a given category ID. Not all category IDs have products; subcategory IDs from get_categories are most reliable. Returns product summaries with name, price, reference, availability, and SEO data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID from get_categories subcategories (e.g. '2546081' for WOMAN > THE NEW). Not all IDs return products; subcategory IDs are most reliable. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>"}'
```

### get_product_details

Returns full details for a single product by its seoProductId. The seoProductId is an 8-digit reference code available from search_products or get_category_products results (in seo.seoProductId field). Returns complete product info including colors, sizes, pricing, and availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product seoProductId (8-digit code, e.g. '04745031'). Available from search_products or get_category_products results at seo.seoProductId. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_product_measurements

Returns size chart and measurements for a product, including size names, body measurements in cm and inches, and a visual shape guide. Uses the internal numeric product ID (not the seoProductId).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Internal numeric product ID (e.g. '507953853') from search_products or get_product_details results (the id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_product_measurements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_related_products

Returns 'Complete Your Look' styling recommendations for a given product. Returns complementary products that pair well with the specified item. Not all products have recommendations; returns an empty array when none are available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Internal numeric product ID (e.g. '512878070') from search_products or get_product_details results (the id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_related_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_shipping_info

Returns shipping methods, delivery times, pricing, and return policies for Zara US. Includes store pickup (free, 3-5 days), home delivery ($4.95-$25), and delivery point options with costs and FAQs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_shipping_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stores

Returns nearby physical Zara stores in the United States by geographic coordinates. Each store includes address, opening hours, available services, and stock threshold info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude of search center (US coordinates, e.g. '40.7128' for New York) |
| `lng` | string | No | Longitude of search center (US coordinates, e.g. '-74.0060' for New York) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/get_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lng":"<string>"}'
```

### search_products

Searches for products by keyword. Returns paginated results with product details including name, price, colors, and availability. Supports section filtering and pagination via offset/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return per page |
| `offset` | integer | No | Pagination offset (number of results to skip) |
| `query` | string | Yes | Search keyword (e.g. 'dress', 'jacket', 'shoes') |
| `section` | string | No | Section filter: WOMAN, MAN, or KIDS |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zara-com-api-24e127dd/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","section":"<string>"}'
```