# Cropp — 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 Cropp's clothing catalog by searching for products, exploring categories, and viewing detailed product information. Retrieve current prices, discounts, and active promotions available across the store.

**Category:** E-commerce | **Website:** [cropp.com/](https://cropp.com/) | **Docs:** [parse.bot/marketplace/9f9da385-7b42-4b67-a042-d619ff453131/cropp-com-api](https://parse.bot/marketplace/9f9da385-7b42-4b67-a042-d619ff453131/cropp-com-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/cropp/`
**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 active promotions

Retrieve current active promotions and discount codes for the Hungarian store. Each promotion includes a coupon code, descriptive text, and type classification.

**Estimated cost:** Metered

_No parameters required._

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

### Get homepage

Retrieve homepage data including active promotions, discount codes, and banner images. Returns the current site title, promotional codes with descriptions, and banner image URLs from the Cropp Hungary homepage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cropp/get-homepage \
  -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 single product including description, material composition, color, sizes with individual stock status and quantity, and high-resolution image URLs. Accepts a product slug (from search_products or list_products_by_category URL field) or a full product URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | Product URL slug (e.g. 'polo-756cu-mlc') or full product URL. The slug can be obtained from search_products or list_products_by_category results. |

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

### List categories

List main product categories available in the store. Returns a static list of top-level categories with their URL paths and IDs usable with list_products_by_category.

**Estimated cost:** Metered

_No parameters required._

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

### List products by category

List products in a specific category by its path. Supports pagination. Returns products filtered by top-level category using Algolia facet filters. Each product includes pricing, sizes, color, sale status, and a URL slug for get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category path. Accepted values: 'noi' (Women), 'ferfi' (Men), 'learazas' (Sale), 'utos-ujdonsag' (New arrivals). |
| `limit` | integer | No | Max results per page (1-100). |
| `page` | integer | No | Page number (0-indexed). |

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

### Search products

Search for products using keywords with pagination support. Returns matching products from the Cropp Hungary catalog via Algolia. Each product includes pricing, available sizes, color, sale status, and a URL slug usable with get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page (1-100). |
| `page` | integer | No | Page number (0-indexed). |
| `query` | string | Yes | Search keyword (e.g. 'polo', 'nadrág', 'farmer'). |

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

## Next steps

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