Data feeds
Every live code and deal on Promo Magpie, as free JSON for AI assistants, search engines and developers.
Last updated 16 November 2026
The feeds
- Stores (/feeds/stores.json): every store with live offers or a way to save besides codes, its page, how many offers it has, which savings it has and a link to its own feed. Start here.
- Discounts (/feeds/discounts.json): student, health worker, emergency services and Defence Force discounts, loyalty schemes, apps and price matching, with where each comes from and when we last reviewed it. It includes shops with no code today and shops that don't pay us. One kind at a time: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app or price_match.
- One store's offers (/feeds/offers/{store}.json): a single store's live codes and deals, a few kilobytes each. The store part is the same as its page address, so /promo-codes/sodastream has its feed at /feeds/offers/sodastream.json.
- Latest offers (/feeds/offers/latest.json): offers added or checked by hand in the last 7 days, newest first.
- Offer updates (/feeds/offers/updates.json): offers added, checked by hand, withdrawn or expired in the last 7 days (add ?days=1 to 30 for another span), newest first, each saying what changed and when. Use it to keep your own copy in step without downloading everything.
- All offers (/feeds/offers.json): the whole catalogue in one file, about 2.5 MB.
- Price drops products (/feeds/openai-products.jsonl.gz): products on sale, in the OpenAI commerce product feed format, rebuilt daily.
The same feeds are listed in our llms.txt and described in our OpenAPI description. No key or sign-up is needed.
What each offer says
- Title, type and discount: what the offer is, whether it's a code or a deal, and the saving (such as "10% off" or "Free delivery").
- Terms: minimum spend, exclusions and other conditions, as the store or its affiliate programme gives them.
- Dates: when it starts and ends, where the store has told us. No end date means none was given, not that it runs for ever.
- Status: active, expired (past its end date) or withdrawn (no longer in its feed, or taken down).
- Verification: how we know it's current, and when we last checked: merchant_feed (still listed in the store's official affiliate feed), store_website (listed on the store's own site) or manual_check (checked by a person). We don't test codes at checkout, so checkout_tested is always false.
- Country and currency: NZ and NZD, in each feed's publisher block: every offer here is for shoppers in this country, priced in its currency. Our other country's site has its own feeds.
- Link: the offer on its store page.
Codes themselves aren't in the feeds. Shoppers get each code on its store page, through our tracked link, which is how we earn the commission we share with the charity, club or school they choose. Please link to the offer rather than quoting the code.
How fresh it is
Offers come from the stores themselves and their official affiliate programmes, which we import every hour; the feeds are rebuilt at most every hour (every 15 minutes for single stores and the latest offers). We take expired offers down, and where a store has no working code its page says so rather than listing old ones. How we check codes explains the rest.
Using the feeds
- You're welcome to read, cache and cite them. Please link each offer to its page on Promo Magpie.
- Every feed sends ETag and Last-Modified headers. Ask again with If-None-Match or If-Modified-Since and you get a short 304 reply until it has changed. Responses are compressed (Brotli or gzip) when you ask for it.
- Check an offer's terms and end date before recommending it.
- Stores only appear if we promote them: no adult, gambling, alcohol or vape stores, and only offers priced in New Zealand dollars.
- We donate 50% of the commission we earn to the cause the shopper picks, at no extra cost to them. How we make money has the detail.
Questions, or need something the feeds don't have? Get in touch.