Weekly price history for everything matching a search term
Weekly price history for everything matching a search TERM (the same matcher as GET /offers/search), across ALL chains, INCLUDING expired offers — catalog_offers is never purged, so this is the term's whole observed history, not just what's live today. One entry per ISO week (Monday start, Europe/Copenhagen) in the window, oldest first; a week with no matching offer still appears, with nulls/0 rather than being omitted. summary.typical_price is the median of the weekly min_price over weeks that had an offer; summary.weeks_on_offer_last_8 counts, of the last 8 weeks, how many had at least one CAMPAIGN offer (a regular shelf price does not count as "on offer"). With chain_slug the series covers only that chain's own offers (its own typical price, cheapest week and weeks on offer).
Request
- Base URL: https://api.shelfatlas.com
- URL: https://api.shelfatlas.com/api/v1/public/catalog/offers/term-history
- Auth: HTTP bearer
Query parameters
Search text, e.g. "pepsi max".
Look-back window in ISO weeks (1–26, default 26).
Restrict the series to a single chain's own offers (SA-0223); omit for all chains. Unknown slug: 404 chain_not_found.
Response
The term's weekly price history and summary.
Changes
No recorded changes to this operation across all 1 revision of this API.