wolt_search
Search restaurants and stores near coordinates by keyword or category, returning venue details and delivery coverage. Browse listings by query, category, or location.
Instructions
Search Wolt restaurants and stores near a coordinate. Returns restaurants and stores near a coordinate, optionally filtered by a keyword or browsed by category. With none of those, this reads Wolt's own plain location browse; with a query it uses Wolt's own keyword search across restaurant/store names, dishes, and cuisines; with a category it browses Wolt's own per-category listing (the same page a homepage cuisine tile links to) -- call /wolt/search/filters for the current, complete, location-scoped list of valid category values. category and query cannot be combined. A keyword search additionally accepts sort, product_line, and open_now; those three apply to keyword search only and return a 400 without query. Each result carries its slug (the value the restaurant and menu endpoints take), name, address, coordinates, tags, price range, rating, and delivery estimate; the two browse modes additionally carry each venue's own category ids. The response also carries is_serviceable, which says whether Wolt delivers to the requested coordinates at all: false means the coordinates are outside Wolt's delivery coverage, so the empty results list is a coverage answer rather than a no-matches answer. A keyword that simply matches nothing inside a covered area returns an empty list with is_serviceable true. Call /wolt/cities for the coordinates of every city Wolt operates in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Optional result ordering. Only applies together with query -- Wolt exposes sorting on its keyword search only, not on its plain browse or category listings. | |
| limit | No | Max restaurants/stores returned. Defaults to 30, maximum 100. | |
| query | No | Optional keyword to search restaurant/store names, dishes, or cuisines by. Cannot be combined with category. | |
| category | No | Optional Wolt category id to browse by instead of a keyword search, e.g. pizza, sushi, vegan. Call /wolt/search/filters for the current, complete, location-scoped list of valid values. Cannot be combined with query. A value Wolt does not recognize at all returns a 404; a real category this particular market does not use returns an empty list, since the taxonomy is location-scoped and markets differ. | |
| latitude | Yes | Search center latitude | |
| open_now | No | When true, restrict results to venues currently delivering. Only applies together with query. | |
| longitude | Yes | Search center longitude | |
| product_line | No | Optional store-type filter. Only applies together with query. Which store types a market actually stocks varies by country; one absent from the searched market returns no results rather than an error. |