Search products (Hebrew/English), priced when a location is given

Free-text catalogue search that also answers 'how much is X' for a single item. With city, near or location every hit carries fromPrice and normalizedUnitPrice and the list comes back cheapest per unit first; without one those fields are absent and the order is by relevance. For a whole shopping list use POST /v1/delivery/optimize instead: these prices sit at different storefronts and each carries its own delivery fee, so they must not be summed.

Requires something to search for: at least one of q, category, brand or gtin. The other parameters narrow a result set rather than choosing one, so a call carrying only those is answered 400 instead of with an arbitrary page of the catalogue.

get/v1/products

Request

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

Query parameters

qstring

Free text in Hebrew or English. Optional only when category, brand or gtin is set.

categorystring
brandstring
gtinstring
limitinteger
citystring

Prefer products priced in this city

nearstring

lat,lng — prefer products priced nearby. Do not combine with location.

locationstring

Free-text neighborhood/address; resolved to coordinates. Do not combine with near.

radius_kmnumber
store_idstring uuid
in_stock_onlyboolean

Response

OK

Changes

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