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

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-marisa-com-br-api-e38c29bf/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-marisa-com-br-api-e38c29bf/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-marisa-com-br-api-e38c29bf/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-marisa-com-br-api-e38c29bf/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```