---
title: "Search Wolt restaurants and stores near a coordinate"
method: GET
path: "/wolt/search"
tags: ["Wolt"]
---

# Search Wolt restaurants and stores near a coordinate

`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`

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.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `query` string
- `category` string
- `limit` integer
- `sort` 'recommended' | 'distance' | 'rating' | 'delivery_fee' | 'delivery_estimate'
- `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'
- `open_now` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- WoltSearchResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` WoltSearchResponse
    - `category` string
    - `is_serviceable` boolean: IsServiceable reports whether Wolt delivers to the requested coordinates at all. False means the coordinates are outside Wolt's delivery coverage, so an empty restaurants list is a coverage answer rather than a no-matches answer. True with an empty list means the location is served but nothing matched. Always present: all three search modes -- plain browse, keyword search, and category browse -- answer it definitively.
    - `open_now` boolean
    - `product_line` string
    - `query` string
    - `restaurants` WoltRestaurant[]
      - `address` string
      - `categories` string[]: Categories are the venue's own category ids, in the same taxonomy /wolt/search's category parameter and /wolt/search/filters use. This is a machine-readable vocabulary, distinct from Tags's free-text display list. Only the two browse modes carry it; a keyword search omits it.
      - `city` string
      - `country` string
      - `currency` string
      - `delivers` boolean
      - `estimate_minutes` integer
      - `estimate_range` string
      - `id` string
      - `image_url` string
      - `latitude` number: Latitude/Longitude are the venue's own coordinates.
      - `longitude` number
      - `name` string
      - `online` boolean
      - `price_range` integer
      - `product_line` string
      - `rating_count` integer
      - `rating_score` number
      - `short_description` string
      - `slug` string
      - `tags` string[]
    - `sort` string
    - `total_results` integer
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)