# Marisa — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 Marisa.com.br's fashion inventory to discover products by category, view detailed item information, and see what other shoppers are currently searching for. Access the complete category structure and identify trending products to stay updated on popular styles from this leading Brazilian fashion retailer.

**Category:** E-commerce | **Website:** [marisa.com.br/](https://marisa.com.br/) | **Docs:** [parse.bot/marketplace/e38c29bf-0c5f-4bc4-804f-dbf91a43a035/marisa-com-br-api](https://parse.bot/marketplace/e38c29bf-0c5f-4bc4-804f-dbf91a43a035/marisa-com-br-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/marisa/`
**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 category products

Browse products by category path on Marisa.com.br. Returns paginated product listings for a given category URL path. Category paths can be discovered from the get_category_tree endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | The URL path to the category, starting with '/' (e.g. '/feminino/c/roupas', '/c/infantil', '/c/masculino') |
| `page` | integer | No | Page number (1-indexed) |

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

### Get category tree

Retrieve the first-level category tree from the main navigation menu of Marisa.com.br. Returns top-level categories with their names and URL paths, useful for discovering category_path values to pass to get_category_products.

**Estimated cost:** Metered

_No parameters required._

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

### Get product details

Retrieve full details for a specific product by ID including name, pricing, available sizes with stock levels, product images, and breadcrumb navigation. The product_id can be obtained from search_products or get_category_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The unique product ID (e.g. '10058458150', '10058547014') |
| `slug` | string | No | The product slug used for URL construction. Optional, defaults to 'product'. |

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

### Search products

Full-text search over Marisa.com.br product catalog. Returns paginated product listings matching the keyword. Each page contains up to ~36 products. The total count is not always available from the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |
| `query` | string | Yes | Search keyword (e.g. 'vestido', 'blusa', 'calcinha') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/marisa/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

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