Food

All food tools are prefixed food_.

Tool	Purpose	Key parameters
food_get_user_discovery_filters	Available filters/sorts at a location	latitude, longitude
food_search_restaurant_items	Search dishes inside one restaurant	restaurant_id, query, coords, limit? (≤30), optional domain? (food | shops | quik)
food_get_restaurant_menu	Full menu	restaurant_id, coords
food_get_item_options	Customization groups for one item (returns catalog_option_ids)	restaurant_id, item_id, coords, optional domain? (food | shops | quik)
food_get_items_options	Same for many items in one call	restaurant_id, item_ids[], coords, optional domain? (food | shops | quik)
food_dish_search	Search dishes across restaurants	query, coords, optional domain?, city_id?, items_limit?, page?, limit?, offset?, sort?, plus more filters (cuisine_ids?, tag_ids?, price?, avr_rating?, delivery_time?, driving_distance?, promo/offer keys)
food_merchant_search	Search restaurants/merchants	query, coords, optional domain?, city_id?, page?, limit?, offset?, sort?, plus more filters (cuisine_ids?, tag_ids?, price?, avr_rating?, delivery_time?, delivery_distance?, promo/offer keys, view?)
food_personalized_search	Personalized restaurant recommendations from the user's own usual restaurants	merchant_names[] (up to 3, ranked best match first), coords
food_get_scheduling_slots	Available delivery/pickup time slots	restaurant_id, coords
food_check_slot_availability	Check if a specific time slot is available	restaurant_id, coords, slot_start, slot_end (exact UTC ISO timestamps from a scheduling slot's from/to)

Domains

food_search_restaurant_items, food_get_item_options, and food_get_items_options support an optional domain parameter: food (default), shops (for specialty shops), or quik (for grocery). Use this to look inside a merchant from a different vertical. The other search tools (food_dish_search, food_merchant_search, food_get_restaurant_menu) also take domain, but only report food (default) as a documented value.

Flow

1. Discover restaurants with food_merchant_search (by name/cuisine) or food_dish_search (by dish), or food_personalized_search for the user's own usual restaurants — use food_get_user_discovery_filters first if you need available filter/sort values.
2. Pull the full menu with food_get_restaurant_menu, or search within one restaurant with food_search_restaurant_items.
3. For customizable items, call food_get_item_options (single) or food_get_items_options (batch) before adding to cart — cart_add_item/cart_add_items need the returned catalog_option_ids.
4. For scheduled orders, check food_get_scheduling_slots then confirm with food_check_slot_availability before passing the slot to checkout.
5. Hand off to Cart & Checkout to build the basket and place the order.

See the Order food journey for the full chain from search to checkout.