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

> 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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```