wolt.com APIwolt.com ↗
Access Wolt venue listings, full menus, item details, ratings, delivery estimates, and city-wide search via 12 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/2b62f42d-c0fd-4009-88c2-2a50d02b3596/get_discovery_page?lat=60.17&lon=24.94' \ -H 'X-API-Key: $PARSE_API_KEY'
Get discovery/home page content for a location. Returns promotional banners, venue sections, and navigation categories available at the given coordinates.
| Param | Type | Description |
|---|---|---|
| latrequired | string | Latitude of the location (e.g. 60.17 for Helsinki). |
| lonrequired | string | Longitude of the location (e.g. 24.94 for Helsinki). |
{
"type": "object",
"fields": {
"sections": "array of content sections including banners and venue lists",
"filtering": "object containing available filter options"
},
"sample": {
"data": {
"sections": [
{
"name": "product-line-navigation-v2",
"items": [
{
"title": "Restaurants",
"template": "product-line-large-v2"
}
],
"template": "product-line-navigation-large"
}
],
"filtering": {},
"page_title": "Discovery"
},
"status": "success"
}
}About the wolt.com API
The Wolt API provides access to 12 endpoints covering the full Wolt delivery platform — from city discovery to per-item customization options. Use get_venue_menu to retrieve complete menu categories, item prices, and topping configurations for any venue, or search_items to find specific dishes across all restaurants in a given city by coordinates.
Venue Discovery and Listings
Pass a lat/lon pair to list_restaurants or list_stores to retrieve venue listings for that location, including venue objects grouped into sections with filter metadata covering categories and price ranges. get_discovery_page returns the same coordinate-based content as Wolt's home screen: promotional banners, curated venue sections, and navigation categories active for that area. get_top_venues narrows this to the five highest-relevance venues at a coordinate, returning each venue's name, slug, rating.score, and rating.volume.
Venue Detail and Menus
get_venue_details takes a venue_slug and returns two objects: static (address, opening times, delivery methods, merchant info) and dynamic (real-time open/close status, delivery time estimates, active promotions). get_venue_menu returns the full menu as three arrays — categories, items (with id, name, price, description, and images), and options (toppings, sizes, extras). For a single item, get_venue_item_details accepts an item_id alongside the venue_slug and returns full option references and variant_groups.
Search and Category Filtering
search_venues and search_items both accept a query string plus optional lat/lon (defaulting to Helsinki when omitted). search_items operates across all restaurants in the target city and returns matched food items rather than venues. For category-based browsing, call list_categories first with a coordinate pair to retrieve the valid category slugs for that city — these slugs are city-specific and must be passed to list_venues_by_category with the same lat/lon. Using a slug from one city in another may return no results.
City Coverage
list_cities requires no inputs and returns an array of all supported cities, each with name, slug, country, and geographic coordinates. This is the recommended starting point for discovering valid lat/lon values before querying any location-scoped endpoint.
- Aggregate restaurant menus and prices across multiple Wolt cities for a food comparison tool
- Monitor real-time venue open/close status and delivery estimates using
get_venue_detailsdynamic fields - Build a cross-city dietary filter by combining
list_categoriesslugs withlist_venues_by_categoryresults - Track rating scores and volumes from
get_top_venuesover time to surface trending restaurants - Index menu item names and prices from
get_venue_menufor a local food search engine - Discover available grocery stores at a coordinate using
list_storesfor a convenience delivery aggregator - Identify all Wolt-supported markets via
list_citiesto scope delivery expansion research
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wolt have an official public developer API?+
What does `get_venue_details` return compared to `list_restaurants`?+
list_restaurants returns venue objects in bulk for a coordinate area, suitable for browsing. get_venue_details takes a single venue_slug and returns much richer data: a static object with full address, opening hours schedule, and delivery method configuration, plus a dynamic object with the current open/close state, live delivery time estimates, and any active promotions on that venue.Are category slugs reusable across different cities?+
list_categories are city-specific. A slug like pizza may exist in Helsinki but not in a different city, or it may map to a different set of venues. Always call list_categories with the same lat/lon pair you intend to use with list_venues_by_category to ensure the slugs are valid for that location.Does the API expose order placement, cart management, or user account data?+
How fresh is the delivery estimate and open/close status data from `get_venue_details`?+
dynamic object in get_venue_details reflects the venue's current operational state each time the endpoint is called. Because Wolt venue availability can change based on time of day and demand, the data is only as current as your most recent request — there is no push or webhook mechanism, so polling is required if you need continuous freshness.