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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/argiro/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/argiro/get-latest-recipes-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/argiro/get-recipe \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/argiro/search-recipes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.