Wolt Restaurants API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
6 optional filters available.
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
Search text, 2 to 100 characters. Without it you get the full list of the point.
coffee shops
string
Optional
Cuisine slug from available_cuisines, for example pizza.
example
string
Optional
One of relevance, rating, eta, distance. Default relevance.
relevance
boolean
Optional
Send true to get only venues that deliver now.
true
integer
Optional
One-based page number (default 1).
1
integer
Optional
Venues 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": "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
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": {
"lat": [
"The latitude is required, e.g. 52.52."
]
},
"message": "The request validation failed"
}Unsupported Country
The point is in a country Wolt does not serve through this API. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "UNSUPPORTED_COUNTRY",
"message": "This country is not supported by this endpoint."
},
"success": false
}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.