Turn a place name or address into latitude/longitude.

Use first when the user gives an address instead of coordinates; every food_* and market_* tool needs lat/long. Results are biased toward near_lat/near_long (default Tehran), so pass a city center for other cities.

Describe coordinates in words (point of interest, street, neighbourhood).

Use to confirm a delivery point with the user before searching.

List cities Snappfood serves, with id, names and center coordinates.

Use the center coordinates as a rough delivery point when the user only names a city.

Search dishes by name near a delivery point, with price, discount and restaurant.

Use for "find X near me" or "discounted X". With sort=relevance it is one fast call on the search index; cheapest / biggest_discount also drop side items (sauces, drinks, extras) and confirm prices against the live menus. For the cheapest X across many restaurant menus use food_find_cheapest.

Find the cheapest way to get a dish: scans menus of nearby open restaurants plus FoodParty deals.

Use when the user wants the lowest total price for X. Ranks by total = food price after discount + packaging + delivery fee; check min_order, since a cheap dish may not reach the restaurant's minimum basket. Slower than food_search.

List restaurants delivering to a point, with rating, delivery fee, ETA and coupon info.

Use to browse or rank restaurants (best rated, free delivery, with discount) or to find a restaurant's vendor code by name. No dish prices: use food_menu for those.

Get one restaurant's menu: every item with price, discount, packaging fee and availability.

Use after picking a restaurant (vendor code from food_search / food_restaurants). final_price = price - discount; packaging is added per item at checkout.

Get the extra costs and conditions of ordering from one restaurant.

Use before recommending a restaurant: delivery fee and ETA here, minimum order, and coupons (each with the basket total it needs and whether it is first-order only). Per-item packaging fees are in food_menu.

Read recent customer reviews of a restaurant (rating, text, what they ordered, vendor reply).

Use to judge quality, delays or packaging before recommending a restaurant.

List today's FoodParty flash deals (deep discounts, limited stock, time window) still in stock.

Use for "what's on a big discount right now". Deals run only inside the window (starts/ends); outside it the list is empty.

List single-person meals (at most 299k Toman, free delivery), cheapest first.

Use for "cheap meal for one". Check min_order: a cheap meal may not reach the restaurant's minimum basket on its own.

List restaurants running a discount now, plus the short "Gem" hunt discount if one is live.

Use for "which restaurants have offers". Vendor-level only; open food_menu for prices.

Search a grocery product across all SnappMarket stores delivering to the point.

Use to see which stores carry an item and at what price. Returns stores (open or not) with up to ~5 matching products each. For a single flat cheapest-first list use market_find_cheapest instead.

Find the cheapest in-stock offers for a grocery product near the point.

Use when the user wants the lowest price for an item. Scans the search results of open stores that deliver to the point and returns one flat list sorted by final price (price - discount). Check delivery_fee and min_order before recommending a store.

List SnappMarket stores delivering to the point, with delivery fee, minimum order and rating.

Use to pick a store (cheapest delivery or best rated) before browsing it with market_store_products.

Get one store's delivery fee, minimum order, opening hours, rating and coupons for the point.

Use before recommending a store to know the true cost of a basket: sum(final prices) + delivery_fee - applicable coupon, and the basket must reach min_order. Read each coupon's conditions; isApplicable is false for logged-out users.

Browse or search the products of one store.

• With query: search the store (takes precedence over category ids).

• With category_id (and optional subcategory_id): list that category's products.

• With neither: list the store's categories and sub-categories with their ids.

List SnappMarket product categories and sub-categories with their ids.

The ids work as category_id / subcategory_id in market_store_products. The first entry (id 99999999) is the virtual kalabarg (government e-coupon eligible) category.

Get one product's details and price in one store.

Use to confirm the current price/discount of an item the user picked.

List current SnappMarket "market party" flash deals near the point, biggest discount first.

Use when the user wants the best grocery discounts right now. Each order may contain at most capacity_per_order deal items. segment 'new_user' deals are only for new customers.

Read a store's 30 most relevant customer comments, rating 0-5.

Use as a quality check before recommending a store. The API returns the same 30 comments whatever the page, so there is no paging.