# Bershka — 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 Bershka's fashion collection by category, color, and size to find exactly what you're looking for. Get comprehensive product details including prices, materials, and real-time availability to make informed shopping decisions.

**Category:** E-commerce | **Website:** [www.bershka.com/es/q/](https://www.bershka.com/es/q/) | **Docs:** [parse.bot/marketplace/2755076c-2ca2-4fc1-8bdc-a22846f32850/bershka-com-api](https://parse.bot/marketplace/2755076c-2ca2-4fc1-8bdc-a22846f32850/bershka-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-bershka-com-api-2755076c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product

Retrieve detailed information for a single product by its numeric ID. Returns full product data including all color variants with per-size pricing and availability, care instructions, and composition details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code determining store locale and language. |
| `product_id` | string | Yes | Numeric product ID (e.g. '229723098'). Obtained from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bershka-com-api-2755076c/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","product_id":"<string>"}'
```

### list_categories

List all available product categories on Bershka with product counts. Categories are derived from Algolia facets and can be used as filter values in the category parameter of search_products. Also returns a top-level hierarchy (e.g. clothes, women, men, shoes).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code determining store locale. |
| `gender` | string | No | Filter categories by gender section. Omit for all. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bershka-com-api-2755076c/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","gender":"<string>"}'
```

### search_products

Full-text search over Bershka's product catalog. Returns products with name, price, image, colors, sizes, and composition. Supports filtering by color, category, and size via Algolia facets. Results are auto-iterated; facets in the response show available filter values and counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by category name in English (e.g. 'T-shirts', 'Jeans', 'Dresses'). Available values returned in facets.categoryNameEn of search results. |
| `color` | string | No | Filter by color name in the store's language (e.g. 'Negro', 'Blanco', 'Rojo' for Spain). Available values returned in facets.colorNameEs of search results. |
| `country` | string | No | Country code determining store locale and language. |
| `limit` | integer | No | Number of products per page (max 224). |
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | Yes | Search query text (e.g. 'camiseta', 'jacket', 'jeans'). |
| `size` | string | No | Filter by size (e.g. 'S', 'M', 'L', 'XL', 'XXS'). Available values returned in facets.sizes of search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bershka-com-api-2755076c/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","color":"<string>","country":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","size":"<string>"}'
```