For app builders and data teams
Supermarket specials, as a feed
The specials at Coles, Woolworths, IGA and ALDI in Australia, and Woolworths NZ, New World and PAK’nSAVE in New Zealand, by state and region, every day. An API that updates daily, a bulk file every Thursday morning, and the history back to the start.
What’s in it
Seven supermarket chains: every product on special, with its shelf price and the deal.
Australia
| Chain | Offer types |
|---|---|
| Coles about 867 stores | Specials, percent off, multi-save, everyday price lines |
| Woolworths about 1,141 stores | Specials and half price |
| IGA about 537 stores | Each store's own specials: percent off, half price, save $X |
| ALDI about 613 (about 200 to 325 read on a given day) stores | Lower prices and limited-time lines (Special Buys), priced by region |
New Zealand
| Chain | Offer types |
|---|---|
| Woolworths NZ about 180 stores | Specials, member prices, percent off, multibuy, clearance, low price lines |
| New World about 150 stores | Specials, Clubcard prices, multibuy |
| PAK'nSAVE about 60 stores | Specials and multibuy |
The fields
| Chain and location | Chain, and the state (Australia) or region (New Zealand) the offer runs in, with how many stores there are on it, price the product and were read that day (in the weekly files from November 2026). Where only some stores are on the offer, the tag price at those stores, else the lowest price there. |
|---|---|
| Product | The retailer's product ID, name, brand and size, and the barcode where the retailer shows one. |
| Price | Shelf price, was price, and unit price with its unit (per kg, per litre, each). |
| Offer | Offer type, the offer as the retailer words it, multibuy terms (“2 for $6”), and whether it's members only. |
| Dates | The day it was read, and the first and last day we saw the offer. |
| Basis | Measured, announced or inferred, on every price. |
Measured and inferred
Every price and offer carries its basis. Measured means we read the price directly from the retailer that day, at one or more of the stores in that state or region; stores_measured says how many, and the other stores on the offer took that price. A measured price is not a claim about any one store. Announced means the price is from the retailer’s catalogue or ALDI’s Special Buys list, read at no store (stores_measured 0). Inferred means no store there was read that day, or we worked the value out: a normal price that is the last shelf price before the offer, or a unit price from the pack size. A product we didn’t read on a day is left out, never shown as not on special. More in the API docs.
When it updates
- Daily. The API updates every morning by 7am Brisbane time with the previous day’s read.
- Weekly drop. A bulk file of the week for each country, cut from Wednesday’s read (the day Coles and Woolworths specials change) and ready on Thursday by 7am Brisbane time.
- History. Australia from 29 September 2026, New Zealand from 10 October 2026, every day since.
Formats
- API: JSON over HTTPS, with an API key. Query by chain, state or region, product, offer type or date.
- Weekly files: CSV and Parquet.
Plans
Monthly, paid by card, cancel any time from your account. Australian dollars, GST not charged.
Starter
$149 a month
- One country: Australia or New Zealand
- Current offers and the last 14 days
- API only
- 60 requests a minute, 10,000 a day
- 3 million rows a month
Growth
$499 a month
- Australia and New Zealand
- The last 90 days
- API and the weekly drop
- 120 requests a minute, 50,000 a day
- 10 million rows a month
Pro
$1,999 a month
- Australia and New Zealand
- Everything since the start
- API, weekly drop and the full history files
- 300 requests a minute, 200,000 a day
- 40 million rows a month
Under the data licence: store it, keep your own history, show prices in your app and build predictions on it. Not for reselling the raw data. Bigger or custom needs? Talk to us.
Questions
Is this scan data?
No. Scan data is what sold at the till, and it comes from the retailers. This feed is the shelf price and the special each retailer shows on its own website: what a shopper sees, not what they bought.
How is it collected?
It's read daily from each retailer's public website. Cannonball is independent and isn't affiliated with any of the retailers.
How far back does it go?
Australia starts on 29 September 2026 and New Zealand on 10 October 2026, with every day since. Pro has all of it; Growth the last 90 days; Starter the current offers and the last 14 days.
Can I show the prices in my app?
Yes. The data licence lets you store the feed, keep your own history, show prices and specials to your users, and build predictions on top. What it doesn't allow is reselling or passing on the raw feed, or using it to build a competing data feed.
What's measured and what's inferred?
Measured means we read the price directly from the retailer that day, at one or more of the stores in that state or region; stores_measured says how many, and the other stores on the offer took that price. A measured price is not a claim about any one store. Announced means the price is from the retailer's catalogue or ALDI's Special Buys list, read at no store (stores_measured 0). Inferred means no store there was read that day, or we worked the value out: a normal price that is the last shelf price before the offer, or a unit price from the pack size. Every price says which, and the API says how many stores were read. A product we didn't read on a day is left out, never shown as not on special.