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

Australian chains in the feed
ChainOffer 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

New Zealand chains in the feed
ChainOffer 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

Fields in each row of the feed
Chain and locationChain, 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.
ProductThe retailer's product ID, name, brand and size, and the barcode where the retailer shows one.
PriceShelf price, was price, and unit price with its unit (per kg, per litre, each).
OfferOffer type, the offer as the retailer words it, multibuy terms (“2 for $6”), and whether it's members only.
DatesThe day it was read, and the first and last day we saw the offer.
BasisMeasured, 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.