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

> Access data from argiro.gr.

**Category:** Food & Dining | **Website:** [www.argiro.gr/](https://www.argiro.gr/) | **Docs:** [parse.bot/marketplace/084e1b52-7dbc-4cf7-a905-208fe8db8162/argiro-gr-api](https://parse.bot/marketplace/084e1b52-7dbc-4cf7-a905-208fe8db8162/argiro-gr-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-argiro-gr-api-084e1b52/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_latest_recipes_by_category

Get the latest recipes in a category from argiro.gr. Returns paginated recipe summaries (12 per page) with title, slug, URL, category tag, and image. The category is specified as a URL slug (e.g. 'glika' for sweets, 'almira' for savory). Subcategories use a path format (e.g. 'almira/salates' for savory salads). Pagination via page parameter; omitting it returns page 1.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug from the site URL (e.g. 'glika', 'almira', 'almira/kotopoulo', 'almira/salates'). Corresponds to the path segment after /recipe-category/ on the site. |
| `page` | integer | No | Page number for pagination (starts at 1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-argiro-gr-api-084e1b52/get_latest_recipes_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_recipe

Get full recipe details by slug. Returns structured recipe data including name, description, ingredients, instructions, timing, servings, category, cuisine, and keywords. The slug is obtainable from search_recipes results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Recipe URL slug (e.g. 'tailandeziko-kotopoulo-me-kokkino-kari'). Obtainable from search_recipes results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-argiro-gr-api-084e1b52/get_recipe \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_recipes

Search recipes on argiro.gr by keyword. Returns paginated recipe summaries (12 per page) with title, slug, category, and image. The site is Greek, so Greek search terms (e.g. 'κοτόπουλο') produce more results than English equivalents. An empty result set is valid for queries with no matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1). |
| `query` | string | Yes | Search query for recipes. Greek terms recommended (e.g. 'κοτόπουλο' for chicken, 'σοκολάτα' for chocolate). |

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