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

> Browse Silpo's complete product catalog by category or keyword search to compare prices and find items from Ukraine's leading online supermarket. Access the full category tree and retrieve detailed product listings with current pricing information to help you shop and make purchasing decisions.

**Category:** Food & Dining | **Website:** [silpo.ua/](https://silpo.ua/) | **Docs:** [parse.bot/marketplace/5ac4eade-dd31-4e5d-9b49-612653104562/silpo-ua-api](https://parse.bot/marketplace/5ac4eade-dd31-4e5d-9b49-612653104562/silpo-ua-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/silpo/`
**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 categories

Get the category tree for Silpo store. Returns all product categories with their slugs and product counts. Use category slugs with get_products to browse products in a specific category. The depth parameter controls how many levels of subcategories are returned (1=top-level only, up to 7 for the full tree).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `depth` | integer | No | Depth of category tree to return (1=top-level only, 7=full tree) |
| `slug` | string | No | Filter to a specific category branch by its slug (e.g. 'frukty-ovochi-4788') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/silpo/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"depth":"<integer>","slug":"<string>"}'
```

### Get products

Get products by category with pagination. Requires either a category slug or search term. Returns product details including prices, ratings, stock levels, and images. Supports sorting by popularity or price. Paginate manually via offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug from get_categories (e.g. 'frukty-ovochi-4788', 'molochni-produkty-ta-iaitsia-234'). Required if search not provided. |
| `in_stock` | string | No | Filter by stock availability: 'true' or 'false' |
| `limit` | integer | No | Number of products per page (max 100) |
| `offset` | integer | No | Pagination offset (0-based item index) |
| `search` | string | No | Search keyword to filter products within category. Required if category not provided. |
| `sort_by` | string | No | Sort field: 'popularity', 'price' |
| `sort_direction` | string | No | Sort direction: 'asc', 'desc' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/silpo/get-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","in_stock":"<string>","limit":"<integer>","offset":"<integer>","search":"<string>","sort_by":"<string>","sort_direction":"<string>"}'
```

### Search products

Search for products by keyword across all categories. Returns matching products with prices, ratings, and stock info. Supports sorting by popularity or price. Paginate manually via offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of products per page (max 100) |
| `offset` | integer | No | Pagination offset (0-based item index) |
| `query` | string | Yes | Search keyword (e.g. 'молоко', 'хліб', 'сир') |
| `sort_by` | string | No | Sort field: 'popularity', 'price' |
| `sort_direction` | string | No | Sort direction: 'asc', 'desc' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/silpo/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","sort_by":"<string>","sort_direction":"<string>"}'
```

## Next steps

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