# Ecco Verde — 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.

> Browse and search the Ecco Verde natural beauty catalogue. Retrieve full product details including ingredients (INCI), variants, and attributes; search by keyword; explore products by category or brand; and fetch personalised product recommendations.

**Category:** E-commerce | **Website:** [ecco-verde.it/](https://ecco-verde.it/) | **Docs:** [parse.bot/marketplace/8fccf138-975d-4c78-9ffa-c2dee8104d03/ecco-verde-it-api](https://parse.bot/marketplace/8fccf138-975d-4c78-9ffa-c2dee8104d03/ecco-verde-it-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-ecco-verde-it-api-8fccf138/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

Get paginated products in a category. Returns up to 30 products per page with total count. Use category slugs from list_categories mainItems[*].path (strip leading slash).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `slug` | string | Yes | Category slug path (e.g. 'make-up/mascara', 'viso/creme-viso'). Obtain from list_categories mainItems[*].path (strip leading slash). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### get_product_detail

Get full product detail by slug. Returns product metadata, description, ingredients (INCI), attributes, variants, and internal IDs usable with get_product_recommendations. The slug follows brand/product-name format as seen in product URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug in brand/product-name format (e.g. 'lavera/basis-sensitiv-moisture-care-shampoo-1'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_product_recommendations

Get recommended products for a specific article item. Use shop_article_id and shop_article_item_id from get_product_detail response. Returns a list of related products with basic info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_article_id` | string | Yes | Internal shop article ID from get_product_detail response. |
| `shop_article_item_id` | string | Yes | Internal shop article item ID from get_product_detail response. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/get_product_recommendations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shop_article_id":"<string>","shop_article_item_id":"<string>"}'
```

### list_brands

List all available brands on ecco-verde.it. Returns an array of brand objects with display name and URL path.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/list_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_categories

List all categories in a hierarchical tree. Returns the full navigation menu structure including brands, product categories, and help items. Each category has a path usable as the slug param in get_category_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for products by keyword on ecco-verde.it. Returns up to 30 products per page with total count. Results include product name, brand, price, rating, and review count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'shampoo', 'crema viso', 'balsamo'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ecco-verde-it-api-8fccf138/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```