Price history for one SKU
price_historyObserved price series for a single retailer SKU over a lookback window. IMPORTANT: the identifier is a retailer-scoped SKU (an external_sku), not a UPC — passing a barcode here will not resolve. Use lookup_product or search_products first to obtain a SKU. A province is required, because the series is scoped to that province's reference stores. Prices are observed on our reference-store panel and are not guaranteed to match every store. When the product name is available, the result includes open_in_vynn_url, an absolute Vynn web link that searches for it; the linked page sets its own store scope, so its prices may differ from this series.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sku": "<sku>",
"banner": "<banner>",
"province": "<province>"
},
"name": "price_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | Yes | Retailer-scoped SKU, from a lookup or search result. | |
| banner | Yes | Retailer banner slug that scopes the SKU, e.g. 'metro'. | |
| period | No | Lookback window in days, e.g. '30d' or '90d'. Default '90d'. | 90d |
| province | Yes | Two-letter Canadian province or territory code, e.g. 'ON', 'BC', 'QC'. Coverage is Canada only. |