Price history
get_price_historyA 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 product at each shop is looked up first, one a shop, so a month of days fits whole, and each row names the product it is for. 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. One credit per row comes to about 31 for one product for a month and about 155 for a product at five shops, and a look-up by name adds one for each shop that has the product.
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.
Returns rows (id, name, store, scrape_date, price, unit_price, unit_basis, clubcard_price, offer_text, was_price), the days covered, not_found, note.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_price_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Most rows to return in all (default and most 200). Fewer than products x days cuts the range to its most recent days for every product. | |
| query | No | Product name words, used when no product_ids are given: the closest match at each shop is looked up, one a shop. | |
| store | No | One shop to look in only that one: aldi, tesco, supervalu, dunnes or lidl. Leave it out for all five. | |
| to_date | No | Last day, YYYY-MM-DD. Left out: today. | |
| from_date | No | First day, YYYY-MM-DD. Left out: 30 days before to_date. | |
| product_ids | No | Product ids exactly as another tool gave them, e.g. ['tesco:300793546', 'dunnes:100873410', '000000000000387044'], up to 50. The sure way to name a product. | |
| with_nutrition_and_ingredients | No | True to add each day's nutrition per 100g or 100ml to every row, and the ingredients list on a product's first day and on any day it changed. Days before 16 October 2026 have none. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | What was left out and why, when anything was | |
| rows | No | One row per product per day recorded, each product's days in order | |
| credits | No | What this answer cost the person's BasketWatch account and what is left. Missing on a free answer | |
| to_date | No | Last day covered, YYYY-MM-DD | |
| products | No | How many products have rows | |
| from_date | No | First day covered, YYYY-MM-DD | |
| not_found | No | Requested ids with no price recorded in the range: an unknown id, or a product not on sale then |