# Albert — 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 discover Albert.cz recipes, find current promotional leaflets with product prices and details, locate nearby stores, and browse magazine content and monthly deals. Access product information and pricing through leaflet data powered by optical character recognition technology.

**Category:** Food & Dining | **Website:** [albert.cz/](https://albert.cz/) | **Docs:** [parse.bot/marketplace/e08617c1-37a1-4a18-a063-a11e3f4d47a7/albert-cz-api](https://parse.bot/marketplace/e08617c1-37a1-4a18-a063-a11e3f4d47a7/albert-cz-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-albert-cz-api-e08617c1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### find_stores

Find Albert store locations. When a query is provided, returns detailed store search results including address, opening hours, and store type. Without a query, returns all store map pins with coordinates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query for store name or city (e.g. 'Praha', 'Brno') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/find_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_current_leaflets

Retrieve current promotional leaflets for Hypermarkets and Supermarkets. Returns leaflet metadata including validity dates, title, cover image URL, view URL (from which the leaflet slug can be extracted), and associated stores.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/get_current_leaflets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_leaflet_detail

Get detailed content of a leaflet including OCR text and image URLs for all pages. The leaflet slug can be extracted from the viewUrl returned by get_current_leaflets (the last path segment before trailing slash).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Leaflet slug extracted from get_current_leaflets viewUrl path (e.g. '24hm_akcni_letak') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/get_leaflet_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_magazine_articles

Retrieve the Albert Magazine CMS page content including articles, structured text components, recipe carousels, and image banners.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/get_magazine_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_monthly_deals

Get current monthly promotional deals (Hit měsíce) CMS page content including promotional images, structured text, and deal descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/get_monthly_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_recipe_detail

Get full details of a specific recipe including ingredients, preparation steps, nutrition info, and images. The recipe ID comes from search_recipes results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Recipe ID from search_recipes results (e.g. 'a10983', 'a1938') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/get_recipe_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### list_recipe_categories

List available recipe categories and filter options. Returns facets for preparation time, difficulty, and special diet with recipe counts per filter value.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/list_recipe_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_recipes

Search for recipes by keyword with optional pagination. Returns paginated results with recipe IDs, titles, ratings, difficulty, preparation time, and image URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | No | Search keyword (e.g. 'smoothie', 'kuřecí', 'salát') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-albert-cz-api-e08617c1/search_recipes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```