# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-silpo-ua-api-5ac4eade/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-silpo-ua-api-5ac4eade/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-silpo-ua-api-5ac4eade/get_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-silpo-ua-api-5ac4eade/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","sort_by":"<string>","sort_direction":"<string>"}'
```