Wolt APIwolt.com ↗
Access Wolt venue listings, full menus, item details, ratings, delivery estimates, and city-wide search via 12 structured API endpoints.
What is the Wolt 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace wolt-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Wolt API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.wolt_api import Wolt, City, Venue, MenuItem, Category, NotFound
wolt = Wolt(api_key="YOUR_API_KEY")
# List available cities to discover valid coordinates
for city in wolt.cities.list(limit=5):
print(city.name, city.slug, city.country_code_alpha2)
# Search for pizza venues in Helsinki
for venue in wolt.venues.search(query="pizza", lat="60.17", lon="24.94", limit=3):
print(venue.name, venue.slug)
# Browse a venue's menu using constructible access
mcd = wolt.venue("mcdonalds-forum-katutaso")
for item in mcd.menu.list(limit=5):
print(item.name, item.price, item.description)
# Get specific menu item details with error handling
try:
details = wolt.menuitems.get(venue_slug="mcdonalds-forum-katutaso", item_id="108dfc16ebe3c9e410522c9e")
print(details.name, details.price)
except NotFound as exc:
print(f"Item not found: {exc}")
# List food categories for Helsinki
for cat in wolt.categories.list(lat="60.17", lon="24.94", limit=10):
print(cat.id, cat.name)
print("exercised: cities.list / venues.search / venue.menu.list / menuitems.get / categories.list")
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"
},
"sample": {
"data": {
"city": "helsinki",
"name": "front",
"sections": [
{
"name": "product-line-navigation-v2",
"items": [
{
"title": "Restaurants",
"template": "product-line-large-v2"
}
],
"template": "product-line-navigation-large"
}
],
"page_title": "Discovery"
},
"status": "success"
}
}About the Wolt API
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.
The Wolt API is a managed, monitored endpoint for wolt.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wolt.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official wolt.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.