delivery

Price a shopping list for delivery across online storefronts

Prices a whole basket at every Israeli online supermarket that delivers to an address and ranks them on what the ORDER costs, not what the goods cost. Online prices are not shelf prices: a chain's website runs its own price book (measured: Rami Levy's online store shares 22% of its prices with its own branches; Carrefour's runs ~8% below its shelves), so every figure comes from the storefront's own regulated feed rows. Storefronts that do not serve the address, sit below the minimum order, or have published no fresh prices for over a week, are returned in unavailableStores with a reason rather than dropped.

post/v1/delivery/optimize

Request

  • Base URL: https://supermcp.co.il
  • URL: https://supermcp.co.il/v1/delivery/optimize
  • Auth: none required

Request body

addressstring

Delivery address in Israel, free text, e.g. 'מנדלסון 1, תל אביב'. Preferred: a storefront whose service area is a polygon or a depot radius can only be tested against a located point.

citystring

Hebrew or English city (or CBS locality code). Enough for a chain that publishes a settlement list; not enough for a polygon or radius service area.

nearstring

'lat,lng', e.g. '32.078,34.774'. Do not combine with address.

preference'cheapest' | 'balanced'

cheapest takes the lowest delivered figure outright; balanced (default) prefers a storefront whose terms we verified when the money is close.

slot_type'standard' | 'pickup'

standard (default) is delivery to the door; pickup is click-and-collect, cheaper where offered but the shopper travels. These are the only two slots any storefront publishes.

membershipsstring[]

Cards or subscriptions the shopper holds that unlock a cheaper rate.

max_split_storesinteger

How many storefronts the returned splitOrder may spread the list over. Default 2. A third adds a third delivery fee, so it only wins when it reaches items the other two do not stock.

include_clubboolean
include_couponboolean
resolution_mode'fast' | 'strict' | 'preview'
response_detail'summary' | 'standard' | 'debug'

How much per-line detail to return. summary gives every storefront's totals, fees and coverage but the lines[] breakdown only for the storefronts the recommendations name; standard returns lines for every storefront; debug adds resolution internals.

intentstring

The shopper's own framing of this shop, in their own words, e.g. 'ברביקיו ל-12 אנשים'. Not a summary of the item list. Shown on the handoff page beside what was priced, so a shopper opening the link sees why they asked. Optional; omit rather than inventing one. Longer text is truncated rather than rejected.

continuationstring

Opaque token from a needs_confirmation, preview or needs_destination reply. Send it with answers, or with a destination, and nothing else: the list travels inside it.

Changes

No recorded changes to this operation across all 1 revision of this API.