price_basket_over_time

com.basketwatchireland/basketwatch · Verify this server

How the cost of the same basket changed between two dates, at the store it was bought from: each product's price on both dates, whether it was on promotion, the basket total on each date, and the products that moved it. BasketWatch has recorded every product's price every night since May 2026 (Lidl's since 17 October 2026). Up to 100 lines per call; each line takes name, sku (the retailer's printed item number, with the line's words in name), barcode, store and quantity. change_pct is the change in what the basket cost (promotions included); shelf_change_pct is regular prices only, so the gap between the two is promotions starting or ending, not price rises. biggest_rises and biggest_falls list the lines that moved most; pack_changed marks a product whose pack size changed, confirmed over three days of records (a smaller pack at the same price is a hidden rise). Lines in not_compared were not found, or not sold on one of the dates. Each product compared costs one credit. Args: items: e.g. [{"sku": "100858349", "quantity": 2}, {"name": "brennans wholemeal bread"}]. from_date: the earlier date, YYYY-MM-DD, e.g. "2026-08-06". to_date: the later date, YYYY-MM-DD; defaults to today. store: the receipt's supermarket (aldi, tesco, supervalu, dunnes or lidl).