get_price_history

com.basketwatchireland/basketwatch · Verify this server

A product's recorded daily prices over a date range. BasketWatch has kept every night's price at Aldi, Tesco, SuperValu and Dunnes Stores since May 2026 and at Lidl since 17 October 2026, and, with with_nutrition_and_ingredients, each day's nutrition per 100g or 100ml and ingredients list as the retailer's own data stated them, kept since 16 October 2026: for questions like "has the sugar in Frosties changed". Takes product ids (as returned in product results; an Aldi id has no store prefix, and "aldi:" in front of one is accepted) or a query; with a query, the closest matching products are looked up first. A range returns one row per product per day, and each row costs one credit; with from_date equal to to_date, one day's price is returned. Every product gets the same days. When products x days would pass the row limit, the range is shortened to its most recent days for all of them and note says so; ids with no price in the range are listed in not_found. Args: product_ids: e.g. ["tesco:300793546", "dunnes:100873410", "000000000000387044"], up to 50; each id's store is taken from it. query: product name words, used when no product_ids are given. store: aldi, tesco, supervalu, dunnes or lidl, to narrow a query. Leave it out to look in all five. from_date: first day, YYYY-MM-DD. Defaults to 30 days before to_date. to_date: last day, YYYY-MM-DD. Defaults to today. limit: most rows to return in total (default and maximum 200). with_nutrition_and_ingredients: true adds nutrition_per_100 to every row and the ingredients list on each product's first day and on any day it changed. Days before 16 October 2026 have none. Returns rows (id, name, store, scrape_date, price, unit_price, unit_basis, clubcard_price, offer_text, was_price), the days covered, not_found, note.