# Dodopizza — 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 Dodo Pizza's menu across Russian cities to discover pizzas, combos, snacks, drinks, and toppings with detailed product information and nutritional details. Search for specific items, find restaurant locations, and view available sauces all tailored to your local city.

**Category:** Food & Dining | **Website:** [dodopizza.ru/](https://dodopizza.ru/) | **Docs:** [parse.bot/marketplace/e79786f9-feef-4c05-a08e-372829181978/dodopizza-ru-api](https://parse.bot/marketplace/e79786f9-feef-4c05-a08e-372829181978/dodopizza-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-dodopizza-ru-api-e79786f9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cities

Returns a list of supported cities with their slugs for use in other endpoints. Static list; no upstream call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_combo_deals

Returns all combo deals for a given city. Combo deals are bundled pizza packages where price depends on the chosen items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's combo deals to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_combo_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_drinks

Returns all drinks for a given city including iced teas, lemonades, juices, and other beverages. Coffee and hot tea are in a separate category on the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's drinks to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_drinks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_menu

Returns the full menu grouped by categories for a specific city. Categories are determined by the site's structure and include Пиццы, Комбо, Римские пиццы, Закуски, Кофе и чай, Напитки, Завтраки, Десерты, Соусы, Любят дети, Другие товары. Category keys are in Russian as returned by the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's menu to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_pizzas

Returns all classic pizzas for a given city. Classic pizzas have multiple size variants (Маленькая, Средняя, Большая).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's pizzas to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_pizzas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_product_details

Returns details for a specific product by its ID including all size variants with nutritional information (calories, proteins, fats, carbs, weight). The product_id can be obtained from any listing endpoint (get_pizzas, get_menu, search_products).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's menu to look up the product in. |
| `product_id` | string | Yes | The unique product ID (from get_pizzas, get_menu, search_products results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","product_id":"<string>"}'
```

### get_restaurant_info

Returns restaurant rating and service information for a given city including average rating, feedback count, total ratings count, and average service time in minutes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's restaurant info to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_restaurant_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_roman_pizzas

Returns all Roman-style pizzas for a given city. Roman pizzas have only one size variant (Маленькая) and feature crispy airy dough.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's Roman pizzas to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_roman_pizzas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_sauces

Returns all sauces for a given city. These are dipping sauces sold as individual portions for pizza crusts and snacks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's sauces to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_sauces \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_snacks

Returns all snacks for a given city including pocket pizzas, wraps, pastas, and other savory items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's snacks to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_snacks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_toppings

Returns all available add-on toppings extracted from menu product ingredient data. Includes both free (included) and paid toppings with their prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's toppings to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dodopizza-ru-api-e79786f9/get_toppings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### search_products

Search for products by keyword query. Matches against product names and descriptions across all menu categories. Returns matching items with their full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | No | City slug identifying which city's menu to search. |
| `query` | string | Yes | Search keyword to match against product names and descriptions (e.g., 'пепперони', 'сырная', 'кофе'). |

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