Wolt

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.

get/wolt/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/wolt/search
  • Auth: API key in header x-api-key

Query parameters

latitudenumber required

Search center latitude

longitudenumber required

Search center longitude

querystring

Optional keyword to search restaurant/store names, dishes, or cuisines by. Cannot be combined with category.

categorystring

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.

limitinteger

Max restaurants/stores returned. Defaults to 30, maximum 100.

sort'recommended' | 'distance' | 'rating' | 'delivery_fee' | 'delivery_estimate'

Optional result ordering. Only applies together with query -- Wolt exposes sorting on its keyword search only, not on its plain browse or category listings.

product_line'restaurant' | 'grocery' | 'alcohol' | 'pharmacy' | 'pet_supply' | 'health_and_beauty' | 'electronics' | 'toys_games_and_kids' | 'home_and_diy' | 'florist' | 'general_merchandise' | 'gift_card' | 'charity' | 'subscription' | 'other'

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.

open_nowboolean

When true, restrict results to venues currently delivering. Only applies together with query.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Changes

No recorded changes to this operation across all 2 revisions of this API.