product_search

Searches the catalogs of approved XEKTA shops (groceries and prepared food for pickup) by name, brand, category or attributes and returns ranked offers with price, stock state and shop details. Shops open now rank first; offers from shops outside their posted hours are included with shop_open_now: false and shop_opens_at, and an order to such a shop goes through only once it opens. With near (a city or neighborhood, a street address, a ZIP code or coordinates) nearby shops rank first and carry distance_miles; if no shop within the radius has a match, the nearest ones are returned instead. Without near the buyer's saved home address is used, or results come unsorted by distance — no location is needed to browse — and location_basis reports which location was used. A general query such as "markets", "grocery stores" or "restaurants" returns a few example items from each shop instead of matching item names. An order a shop does not answer within 10 minutes is cancelled automatically and nothing is charged. An offer with image_url has a photo: image_source "shop" is the shop's own photo, "stock" is a XEKTA stock photo of the dish that is only to be displayed together with its image_note label. Read-only. Results are built as a picture menu: show them as picture cards (image_url, name, price) by default, without waiting for the buyer to ask for pictures; on clients that render MCP Apps the cards come with the result. A query with a shop name and the word menu, such as "Borek-G menu", returns that shop's full menu in one call, ready-to-eat items first, 60 items per page (page: 2 for the next). When two or more restaurants or markets match, the result has mode "shops" with the shops listed (shops_total, more) and the ordinary results alongside; a single matching shop gives mode "shop_dishes" with that shop's header; the optional shop_id limits the search to one shop.