# Perekrestok — 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 Perekrestok.ru's grocery catalog, search for products, view detailed information and customer reviews, and explore items organized by category. Get instant access to product details, pricing, and shopper feedback to help you find exactly what you need from Russia's leading supermarket chain.

**Category:** Food & Dining | **Website:** [perekrestok.ru/](https://perekrestok.ru/) | **Docs:** [parse.bot/marketplace/61192e56-ebb6-4787-85b8-0b8e3a63f328/perekrestok-ru-api](https://parse.bot/marketplace/61192e56-ebb6-4787-85b8-0b8e3a63f328/perekrestok-ru-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-perekrestok-ru-api-61192e56/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Get full category tree or children of a specific category

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `parent_id` | integer | No | Parent category ID (optional) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-perekrestok-ru-api-61192e56/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parent_id":"<integer>"}'
```

### get_category_products

Get paginated list of products in a category

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | Yes | Category ID |
| `page` | integer | No | Page number |
| `per_page` | integer | No | Results per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-perekrestok-ru-api-61192e56/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>","per_page":"<integer>"}'
```

### get_product_details

Get full details for a specific product

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `plu` | string | Yes | Product PLU code or ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-perekrestok-ru-api-61192e56/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plu":"<string>"}'
```

### get_product_reviews

Get user reviews for a product

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number |
| `per_page` | integer | No | Results per page |
| `plu` | string | Yes | Product PLU code or ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-perekrestok-ru-api-61192e56/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","plu":"<string>"}'
```

### search_products

Search products by keyword

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number |
| `query` | string | Yes | Search query |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-perekrestok-ru-api-61192e56/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```