wolt_search
Search Wolt restaurants and stores near any coordinates, with optional keyword or category filters, and get ratings, delivery estimates, and coverage status.
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. |