# Cropp — 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.

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/get_active_promotions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/list_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cropp-com-api-9f9da385/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```