# Zara Home — 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 Zara Home's furniture and home décor catalog. Retrieve product details including name, category, price, available sizes or dimensions, materials, colors, and availability status. Browse by category or search by keyword across the full product range.

**Category:** E-commerce | **Website:** [zarahome.com/](https://zarahome.com/) | **Docs:** [parse.bot/marketplace/6cc2ad0d-ceab-457c-8dbf-20cca46729e5/zarahome-com-api](https://parse.bot/marketplace/6cc2ad0d-ceab-457c-8dbf-20cca46729e5/zarahome-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-zarahome-com-api-6cc2ad0d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Returns the top-level navigation categories for the Zara Home US store. The list is static and includes broad sections like Bedroom, Living Room, Kitchen, and Sale. Each category carries an ID usable with get_category_products.

**Estimated cost:** Metered

_No parameters required._

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

### get_category_products

Retrieves products belonging to a specific category. Returns full product detail for each item (composition, colors, sizes, pricing). Response time scales with limit since each product requires a detail fetch. Category IDs come from get_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID obtained from get_categories endpoint (e.g. '1020611313' for Bedroom, '1020495068' for Kitchen, '1020264592' for Living Room). |
| `limit` | integer | No | Maximum number of products to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zarahome-com-api-6cc2ad0d/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>"}'
```

### get_product_details

Fetches the full detail record for a single product including composition, care instructions, all available color variants with sizes and pricing, and related products. Providing the correct category_id may yield richer data for some products. Product IDs can be obtained from search_products or get_category_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Category context ID. Providing the correct category ID from get_categories may yield richer data for some products. |
| `product_id` | string | Yes | Product ID (numeric string, e.g. '479911914'). |

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

### search_products

Full-text search over the Zara Home US product catalog. Returns paginated results with product details including name, description, composition, care instructions, colors, and sizes. Each result includes full detail data fetched per-product, so response time scales with limit. Some products may return empty colors/care/composition depending on upstream data availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of products to return. |
| `offset` | integer | No | Pagination offset (number of products to skip). |
| `query` | string | Yes | Search keyword (e.g. 'duvet', 'cotton', 'candle'). |

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