# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cea-com-br-api-0da22320/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-cea-com-br-api-0da22320/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-cea-com-br-api-0da22320/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-cea-com-br-api-0da22320/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-cea-com-br-api-0da22320/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-cea-com-br-api-0da22320/get_subcategory_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-cea-com-br-api-0da22320/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```