# C&A Brazil — 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 C&A Brazil's product catalog across categories and subcategories, view detailed product information including prices and specifications, and read customer reviews to help with your shopping decisions. Find exactly what you're looking for with powerful product search functionality backed by the complete cea.com.br inventory.

**Category:** E-commerce | **Website:** [cea.com.br/](https://cea.com.br/) | **Docs:** [parse.bot/marketplace/0da22320-8b55-4f50-b578-999e731e03a3/cea-com-br-api](https://parse.bot/marketplace/0da22320-8b55-4f50-b578-999e731e03a3/cea-com-br-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/c-and-a-brazil/`
**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

Retrieve the full category hierarchy tree up to 3 levels deep. Returns all top-level categories with nested children and URLs. No parameters required. Use the returned slugs (from URL paths) with get_category_products and get_subcategory_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get category products

Retrieve products for a top-level category by slug. Filters Algolia results by Category1. Returns the same paginated structure as search_products. Use get_categories to discover valid category slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug in lowercase hyphenated format (e.g. 'moda-feminina', 'moda-masculina', 'infantil') |
| `limit` | integer | No | Number of results per page (max 48) |
| `page` | integer | No | Page number (0-indexed) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Get product details

Get full details for a specific product by its numeric product ID. Returns comprehensive product information including name, brand, description, SKU items with sizes and prices, images, categories, and specifications. The product_id is available from search results (hits[*].productId).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID (e.g. '4544838', from search_products results hits[*].productId) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### Get product reviews

Retrieve customer reviews (opinions) for a product by its numeric product ID. Returns up to 50 positive reviews sorted by most recent. Each review includes rating, text, date, and user name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID (e.g. '4544838', from search_products results hits[*].productId) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### Get subcategory products

Retrieve products filtered by both a top-level category and a subcategory. Filters Algolia results by Category1 AND Category2. Returns the same paginated structure as search_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Parent category slug (e.g. 'moda-feminina', 'moda-masculina') |
| `limit` | integer | No | Number of results per page (max 48) |
| `page` | integer | No | Page number (0-indexed) |
| `subcategory_slug` | string | Yes | Subcategory slug (e.g. 'roupas', 'acessorios', 'calcados', 'moda-intima') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/get-subcategory-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","limit":"<integer>","page":"<integer>","subcategory_slug":"<string>"}'
```

### Search products

Full-text search over C&A Brazil's product catalog via Algolia. Returns paginated results including product name, price, availability, images, and category hierarchy. Each hit carries a productId usable with get_product_details and get_product_reviews. Pagination is 0-indexed; nbPages in the response indicates total pages available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page (max 48) |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | Yes | Search keyword (e.g. 'camiseta', 'calca', 'vestido') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-and-a-brazil/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<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.