# Wolt — 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 and discover restaurants, stores, and food items available on the Wolt delivery platform, with access to detailed menus, venue information, and the ability to search across categories and cities. Filter venues by location, explore their complete offerings, and find specific items to compare options across the Wolt network.

**Category:** Food & Dining | **Website:** [wolt.com/](https://wolt.com/) | **Docs:** [parse.bot/marketplace/a7730aee-2b8c-4600-872f-3b9854bc3607/wolt-com-api](https://parse.bot/marketplace/a7730aee-2b8c-4600-872f-3b9854bc3607/wolt-com-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-wolt-com-api-a7730aee/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_discovery_page

Get discovery/home page content for a location. Returns promotional banners, venue sections, and navigation categories available at the given coordinates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/get_discovery_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### get_top_venues

Get top 5 venues for a location, extracted from the restaurant listing sorted by default relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/get_top_venues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### get_venue_details

Get detailed info for a specific venue including address, opening hours, delivery configuration, ratings, and real-time availability status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `venue_slug` | string | Yes | Venue slug identifier (e.g. mcdonalds-forum-katutaso). Obtainable from list_restaurants or search_venues results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/get_venue_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"venue_slug":"<string>"}'
```

### get_venue_item_details

Get details for a specific menu item including customization options and variant groups. Requires both the venue slug and item ID from get_venue_menu.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Item ID from the venue menu. Obtainable from get_venue_menu results. |
| `venue_slug` | string | Yes | Venue slug identifier (e.g. mcdonalds-forum-katutaso). Obtainable from list_restaurants or search_venues results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/get_venue_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","venue_slug":"<string>"}'
```

### get_venue_menu

Get full menu for a venue including all categories, items with prices, and customization options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `venue_slug` | string | Yes | Venue slug identifier (e.g. mcdonalds-forum-katutaso). Obtainable from list_restaurants or search_venues results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/get_venue_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"venue_slug":"<string>"}'
```

### list_categories

List available food categories for a location. Categories are city-specific and can be used with list_venues_by_category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### list_cities

List all supported cities and their coordinates. Useful for discovering valid lat/lon values to use with other endpoints.

**Estimated cost:** Metered

_No parameters required._

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

### list_restaurants

List all restaurants for a location. Returns venue listings with filtering and sorting options. Includes categories section and full venue-vertical-list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/list_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### list_stores

List grocery stores for a location. Returns grocery venue listings filtered from search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/list_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### list_venues_by_category

List venues filtered by category slug. Uses search to find venues matching the category name. Category slugs are city-specific — use list_categories with the same lat/lon to discover valid slugs for a given location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug to filter by (e.g. pizza, sushi, salad). Must be a valid slug for the given location — obtain from list_categories endpoint with the same coordinates. |
| `lat` | string | Yes | Latitude of the location (e.g. 60.17 for Helsinki). |
| `lon` | string | Yes | Longitude of the location (e.g. 24.94 for Helsinki). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/list_venues_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","lat":"<string>","lon":"<string>"}'
```

### search_items

Search for food/menu items across all restaurants in a city. Returns matching menu items with venue info. If lat/lon are omitted, defaults to Helsinki.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude of the location. Defaults to Helsinki (60.17) if omitted. |
| `lon` | string | No | Longitude of the location. Defaults to Helsinki (24.94) if omitted. |
| `query` | string | Yes | Search query (e.g. pizza, burger, pasta). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>","query":"<string>"}'
```

### search_venues

Search for restaurants or stores by query. Returns matching venues for the given location. If lat/lon are omitted, defaults to Helsinki.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude of the location. Defaults to Helsinki (60.17) if omitted. |
| `lon` | string | No | Longitude of the location. Defaults to Helsinki (24.94) if omitted. |
| `query` | string | Yes | Search query (e.g. sushi, pizza, McDonald's). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wolt-com-api-a7730aee/search_venues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>","query":"<string>"}'
```