GroceryPulse Canada

Compares current public chain prices for a list of catalogue item ids (from get_grocery_catalog) and quantities in one supported Canadian city; plan_grocery_order is the form that takes a list in the shopper's own words. A lowest-chain recommendation requires fresh full requested coverage at two eligible chains with no close call or package/reference-size reversal. Results keep missing items, exclusions, price dates, scope and source links, and each chain includes plain per-item storeLinks to its own product page or search, with the price date used. Each id is one product at its catalogue size (for example 4 L milk); a different size, variant or brand is a different product. Chain medians are not branch stock or guaranteed checkout quotes. Read-only: it does not buy, save a list, send email or access licensed or private data.

Lists GroceryPulse's configured Canadian cities, canonical reference items with their ids, quantity units, known chains and checkout eligibility holds: the ids that compare_grocery_list takes. Configured coverage is not current availability or coverage of every nearby branch. Each item is one product at one package size (its name and referenceSize); a different size, variant or brand is a different product.

Plans a grocery order from a shopping list as the shopper wrote it, in a covered Canadian city. Use when a shopper asks where their list is cheapest or wants to buy groceries online. Takes the list as text (English or French, quantities included, up to 60 lines), the city or the first three characters of a postal code inside it and, optionally, the stores the shopper uses. Returns each line as exact, closest (a different size, variant or brand: not priced and in no total) or not tracked; per-store totals with coverage and price dates; a cheapest store only when every compared item is priced at two or more chains with a clear lead (or, when the only obstacle is a pack item whose count no store's listing gives, a store labelled cheapest for the other lines, with those lines listed apart), otherwise the reason; per-item links to each store's own product page or search; and interpretation notes that state what the result does and does not cover. Read-only: it never orders, adds to a cart, saves a list or contacts a store.