# Catalogodigital Somosbelcorp — 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.

> Access Belcorp's product catalogs, pricing, and detailed product information across multiple countries and brands—search for specific items, browse by catalog, or look up individual product details. All you need is to select your country and start retrieving the data you need without worrying about authentication.

**Category:** E-commerce | **Website:** [catalogodigital.somosbelcorp.com/](https://catalogodigital.somosbelcorp.com/) | **Docs:** [parse.bot/marketplace/fb60e5af-a48d-4c6e-be68-b046763fb446/catalogodigital-somosbelcorp-com-api](https://parse.bot/marketplace/fb60e5af-a48d-4c6e-be68-b046763fb446/catalogodigital-somosbelcorp-com-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-catalogodigital-somosbelcorp-com-api-fb60e5af/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_catalog_detail

Returns detailed information for a specific catalog, including all pages with images and product mappings. Uses the catalog ID from get_catalogs. Response includes page-level product positions and pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `catalog_id` | string | Yes | Catalog ID from get_catalogs |
| `country_code` | string | Yes | ISO country code (e.g. MX, CO, PE) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/get_catalog_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"catalog_id":"<string>","country_code":"<string>"}'
```

### get_catalogs

Returns the active campaign, catalogs, and categories for a given country. Each catalog includes brand info and category listings. The campaign code returned is needed for product-level endpoints. Campaigns rotate periodically; always fetch the current one before querying products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | Yes | ISO country code as returned by select_country (e.g. MX, CO, PE, BO, CL, CR, EC, SV, GT, PA, PR, DO, US) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/get_catalogs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>"}'
```

### get_product_detail

Returns full product details by CUV, including descriptions, pricing, variants, images, and linked strategy/offers. CUV values are obtained from get_products_by_catalog. Products are campaign-specific; use the current campaign_code from get_catalogs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_code` | string | Yes | Brand code: E (Ésika), L (L'Bel), or C (Cyzone) |
| `campaign_code` | string | Yes | Campaign code from get_catalogs (e.g. 202609) |
| `country_code` | string | Yes | ISO country code (e.g. MX, CO, PE) |
| `cuv` | string | Yes | CUV identifier from get_products_by_catalog (e.g. 05598) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_code":"<string>","campaign_code":"<string>","country_code":"<string>","cuv":"<string>"}'
```

### get_products_by_catalog

Returns all product mappings (SKU, CUV, page number) for a specific catalog brand and campaign. The CUV values returned are used as input for get_product_detail. Each entry maps a product to its catalog page position.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_code` | string | Yes | Brand code: E (Ésika), L (L'Bel), or C (Cyzone) |
| `campaign_code` | string | Yes | Campaign code from get_catalogs (e.g. 202609) |
| `country_code` | string | Yes | ISO country code (e.g. MX, CO, PE) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/get_products_by_catalog \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_code":"<string>","campaign_code":"<string>","country_code":"<string>"}'
```

### search_products

Searches for products across all active catalogs by keyword. Returns matching products with full details including pricing, images, and brand information. Results span all three brands (Ésika, L'Bel, Cyzone) for the given country and campaign.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `campaign_code` | string | Yes | Campaign code from get_catalogs (e.g. 202609) |
| `country_code` | string | Yes | ISO country code (e.g. MX, CO, PE) |
| `query` | string | Yes | Search keyword (e.g. perfume, labial, crema) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_code":"<string>","country_code":"<string>","query":"<string>"}'
```

### select_country

Returns the list of available countries for the Belcorp catalog platform. Each country carries an ISO code usable as input for all country-scoped endpoints, plus a flag image URL. The list is stable across campaigns.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-catalogodigital-somosbelcorp-com-api-fb60e5af/select_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```