# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/zara-home/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/zara-home/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/zara-home/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/zara-home/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/zara-home/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.