# Wolt Dishes API Documentation

<p><strong>Wolt Dishes API Documentation</strong> Search dishes by text across the Wolt venues that deliver to a point. Each dish has id, name, description, price with currency, image, availability and the venue that sells it (id, slug, name, rating from 0 to 10, delivery time, image). One search returns up to 200 dishes. Sort by relevance, price_asc, price_desc or rating; the page and the sort are applied to those 200 dishes. Take the venue slug and open the venue or menu endpoint. Cost: 1 credit per successful request.</p>

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

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Dish search text, 2 to 100 characters, for example pizza. |
| `lat` | number | Yes | Latitude of the delivery point, for example 52.52. |
| `lon` | number | Yes | Longitude of the delivery point, for example 13.405. |
| `sort` | string | No | One of relevance, price_asc, price_desc, rating. Default relevance. |
| `page` | integer | No | One-based page number (default 1). |
| `per_page` | integer | No | Dishes per page, 1 to 100 (default 20). |

## Example response

```json
{
    "data": {
        "sort": "price_asc",
        "count": 1,
        "point": {
            "lat": 52.52,
            "lon": 13.405
        },
        "query": "pizza",
        "dishes": [
            {
                "id": "82c95550f0586c993230492a",
                "name": "Pizza Queen Margherita",
                "tags": [],
                "price": {
                    "amount": 12.9,
                    "currency": "EUR"
                },
                "venue": {
                    "id": "669772ecdecae30757112800",
                    "name": "72 ore by NeaPizza1889",
                    "slug": "72-ore-by-neapizza1889",
                    "rating": {
                        "count": 806,
                        "scale": 10,
                        "score": 8.8
                    },
                    "image_url": null,
                    "eta_max_minutes": 35,
                    "eta_min_minutes": 25
                },
                "available": true,
                "image_url": "https://wolt-menu-images-cdn.wolt.com/menu-images/example.jpeg",
                "description": "with San Marzano tomatoes, fior d'agerola, basil",
                "sold_by_weight": false
            }
        ],
        "pagination": {
            "page": 1,
            "total": 200,
            "per_page": 20,
            "total_pages": 10
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "wolt_dishes"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. 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)
