# Wolt Restaurants API Documentation

<p><strong>Wolt Restaurants API Documentation</strong> List the Wolt venues that deliver to a point, or search them by text. Each venue has id, slug, name, address, position, rating with review count (score from 0 to 10), price range, cuisine tags, delivery time, open status, distance in meters and promotion texts. The list has no delivery fee and no minimum order: read them from the venue endpoint. The country follows the point; 23 countries are supported, and any other point answers 422. Filter with cuisine (a slug from available_cuisines) and open_now. Sort by relevance, rating, eta or distance. Page N holds page N; a page past the end is an empty list. The venue list of a point is shared for 5 minutes, so the points of nearby calls give the same list. Use slug for the venue and menu endpoints. Cost: 1 credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/wolt-api/wolt_restaurants](https://scrappa.co/docs/wolt-api/wolt_restaurants)
- **API group:** Wolt API
- **Endpoint:** `GET https://scrappa.co/api/wolt/restaurants`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `lat` | number | Yes | Latitude of the delivery point, for example 52.52. |
| `lon` | number | Yes | Longitude of the delivery point, for example 13.405. |
| `query` | string | No | Search text, 2 to 100 characters. Without it you get the full list of the point. |
| `cuisine` | string | No | Cuisine slug from available_cuisines, for example pizza. |
| `sort` | string | No | One of relevance, rating, eta, distance. Default relevance. |
| `open_now` | boolean | No | Send true to get only venues that deliver now. |
| `page` | integer | No | One-based page number (default 1). |
| `per_page` | integer | No | Venues per page, 1 to 100 (default 20). |

## Example response

```json
{
    "data": {
        "sort": "relevance",
        "count": 1,
        "point": {
            "lat": 52.52,
            "lon": 13.405
        },
        "query": null,
        "cuisine": "chinese",
        "open_now": false,
        "pagination": {
            "page": 1,
            "total": 256,
            "per_page": 20,
            "total_pages": 13
        },
        "restaurants": [
            {
                "id": "633d7eec056442ed9fe2e78c",
                "name": "WEN CHENG 2 Rosa-Luxenburg",
                "slug": "wen-cheng-2-hand-pulled-noodles",
                "tags": [
                    "chinese",
                    "noodles",
                    "asian"
                ],
                "rating": {
                    "count": 560,
                    "scale": 10,
                    "score": 8.6
                },
                "address": {
                    "lat": 52.530688,
                    "lon": 13.411648,
                    "city": null,
                    "line": "Sch\u00f6nhauser Allee 10",
                    "country": "DEU"
                },
                "currency": "EUR",
                "delivery": {
                    "open_now": true,
                    "available": true,
                    "eta_minutes": 25,
                    "eta_max_minutes": 30,
                    "eta_min_minutes": 20
                },
                "logo_url": "https://images.example.com/venues/logo",
                "image_url": "https://images.example.com/venues/venue",
                "distance_m": 149,
                "promotions": [],
                "description": "Chinese Handpulled Noodles",
                "price_range": 2
            }
        ],
        "available_cuisines": [
            {
                "slug": "asian",
                "count": 350
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "wolt_restaurants"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 422 | Unsupported Country | The point is in a country Wolt does not serve through this API. This response is not billable. |
| 404 | Not Found | No such restaurant, product or page exists. Use the ids and slugs from the restaurants endpoint. This response is not billable. |
| 503 | Service Unavailable | Wolt could not be reached or is busy. Retry in a few seconds. This response is not billable. |
| 502 | Bad Gateway | Wolt answered in a form this API does not know. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)