Wolt Dishes API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
3 required parameters needed before sending a request.
3 optional filters available.
string
Required
Dish search text, 2 to 100 characters, for example pizza.
coffee shops
number
Required
Latitude of the delivery point, for example 52.52.
10
number
Required
Longitude of the delivery point, for example 13.405.
10
string
Optional
One of relevance, price_asc, price_desc, rating. Default relevance.
relevance
integer
Optional
One-based page number (default 1).
1
integer
Optional
Dishes per page, 1 to 100 (default 20).
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"query": [
"A dish search text is required, e.g. pizza."
]
},
"message": "The request validation failed"
}Not Found
No such restaurant, product or page exists. Use the ids and slugs from the restaurants endpoint. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "NOT_FOUND",
"message": "No such restaurant, product or page was found. Use the ids from the restaurants endpoint."
},
"success": false
}Service Unavailable
Wolt could not be reached or is busy. Retry in a few seconds. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Wolt API is temporarily unavailable. Please retry."
},
"success": false
}Bad Gateway
Wolt answered in a form this API does not know. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "PARSER_DRIFT",
"message": "Wolt rejected the request. Check the parameters and try again."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.