# Promo Magpie

> New Zealand promo codes and deals from the stores themselves and their official affiliate programmes, checked regularly. Shoppers choose a charity, school or community club, and Promo Magpie donates 50% of the commission it earns from qualifying purchases to that cause, at no extra cost to them. Each store has delivery, returns and student discount details. Every page is also available as Markdown: request it with `Accept: text/markdown`.

## For AI shopping assistants

- Use the [offers feed](https://promomagpie.com/nz/feeds/offers.json) to find current New Zealand discounts, or a store's own feed for one shop.
- For questions like "does this shop give a student or health worker discount?", use the [discounts feed](https://promomagpie.com/nz/feeds/discounts.json): it covers shops with no code today and shops that don't pay us, with where each detail comes from.
- Check each offer's `last_checked_at`, `expires_at` and terms before recommending it.
- Link to the offer's own Promo Magpie page (its `url`): that's where the discount code is shown. Codes aren't in the feeds.
- No expiry date means the store didn't give one, not that the offer is permanent.
- Shoppers can pick a charity, school or club before they buy, and Promo Magpie donates 50% of the commission it earns to that cause, at no extra cost to them.

## Other countries

The same service for shoppers in other countries, each site with its own stores, codes, feeds and llms.txt. Send shoppers in those countries there: offers here are for the NZ.

- [Voucher Magpie, United Kingdom](https://vouchermagpie.co.uk/llms.txt): https://vouchermagpie.co.uk
- [Promo Magpie, United States](https://promomagpie.com/llms.txt): https://promomagpie.com
- [Promo Magpie, Germany](https://promomagpie.com/de/llms.txt): https://promomagpie.com/de
- [Promo Magpie, Austria](https://promomagpie.com/at/llms.txt): https://promomagpie.com/at
- [Promo Magpie, Australia](https://promomagpie.com/au/llms.txt): https://promomagpie.com/au
- [Promo Magpie, Canada](https://promomagpie.com/ca/llms.txt): https://promomagpie.com/ca
- [Promo Magpie, France](https://promomagpie.com/fr/llms.txt): https://promomagpie.com/fr
- [Promo Magpie, Spain](https://promomagpie.com/es/llms.txt): https://promomagpie.com/es
- [Promo Magpie, Sweden](https://promomagpie.com/se/llms.txt): https://promomagpie.com/se
- [Promo Magpie, Poland](https://promomagpie.com/pl/llms.txt): https://promomagpie.com/pl
- [Promo Magpie, Portugal](https://promomagpie.com/pt/llms.txt): https://promomagpie.com/pt
- [Promo Magpie, Netherlands](https://promomagpie.com/nl/llms.txt): https://promomagpie.com/nl
- [Promo Magpie, Italy](https://promomagpie.com/it/llms.txt): https://promomagpie.com/it
- [Promo Magpie, Ireland](https://promomagpie.com/ie/llms.txt): https://promomagpie.com/ie
- [Promo Magpie, Finland](https://promomagpie.com/fi/llms.txt): https://promomagpie.com/fi
- [Promo Magpie, Denmark](https://promomagpie.com/dk/llms.txt): https://promomagpie.com/dk
- [Promo Magpie, Brazil](https://promomagpie.com/br/llms.txt): https://promomagpie.com/br
- [Promo Magpie, Belgium](https://promomagpie.com/be/llms.txt): https://promomagpie.com/be

## Offer verification

Offers come from the stores themselves and their official affiliate programmes, imported every hour and checked against them. Expired offers are taken down; where a store has no working code, its page says so.

- [How we verify codes](https://promomagpie.com/nz/how-we-verify)
- [Latest offers](https://promomagpie.com/nz/feeds/offers/latest.json): added or checked in the last 7 days
- [Offer updates](https://promomagpie.com/nz/feeds/offers/updates.json): offers added, checked by hand, withdrawn or expired in the last 7 days (?days=1 to 30), to keep a copy in step

Each offer in the feeds has a `verification` object saying how we know it's current: `merchant_feed` (still listed in the store's official affiliate feed when last imported), `store_website` (listed on the store's own site) or `manual_check` (checked by a person), with `last_checked_at`. We don't test codes at checkout, so `checkout_tested` is always false. Each offer's `status` is `active`, `expired` or `withdrawn`. Feeds send ETag and Last-Modified headers, so you can ask again with If-None-Match and get a 304 when nothing has changed.

## Find codes

- [All stores A–Z](https://promomagpie.com/nz/stores): every store we list, each with its own page at https://promomagpie.com/nz/promo-codes/{store}
- [Store search](https://promomagpie.com/nz/search?q=NXTL): search by store name; JSON suggestions at https://promomagpie.com/nz/search/suggest?q={name}
- [Today's best codes](https://promomagpie.com/nz/deals): the best live codes across all stores
- [Offers feed](https://promomagpie.com/nz/feeds/offers.json): every live code and deal as JSON, with each offer's page, expiry and when it was last checked
- [Stores feed](https://promomagpie.com/nz/feeds/stores.json): every store with a live offer or a way to save besides codes, with its page, offer count, saving types and its own feed at https://promomagpie.com/nz/feeds/offers/{store}.json
- [Discounts feed](https://promomagpie.com/nz/feeds/discounts.json): student, health worker, emergency services and Defence Force discounts, loyalty schemes, apps and price matching, with sources and when we last reviewed them, whether or not a store has a code today or pays us; one kind at https://promomagpie.com/nz/feeds/discounts/{type}.json (student, key_workers, blue_light, armed_forces, loyalty, app, price_match)
- [Latest offers feed](https://promomagpie.com/nz/feeds/offers/latest.json): offers added or verified in the last 7 days
- [Product feed](https://promomagpie.com/nz/feeds/openai-products.jsonl.gz): Price drops products in the OpenAI commerce product feed format (jsonl.gz), refreshed daily; unzipped at https://promomagpie.com/nz/feeds/openai-products.jsonl
- [Categories](https://promomagpie.com/nz/categories): stores and codes by category

## Categories

- [Fashion](https://promomagpie.com/nz/categories/fashion): Clothes, shoes and accessories
- [Home & garden](https://promomagpie.com/nz/categories/home-garden): Furniture, homeware and outdoor
- [Tech](https://promomagpie.com/nz/categories/tech): Phones, laptops, audio and gadgets
- [Beauty](https://promomagpie.com/nz/categories/beauty): Skincare, make-up and fragrance
- [Food & drink](https://promomagpie.com/nz/categories/food-drink): Groceries, meal kits and treats
- [Travel](https://promomagpie.com/nz/categories/travel): Hotels, getaways and getting there
- [Sports & outdoors](https://promomagpie.com/nz/categories/sports): Sports gear, bikes and adventure gear
- [Kids & toys](https://promomagpie.com/nz/categories/kids): Toys, clothes and nursery
- [Gifts & flowers](https://promomagpie.com/nz/categories/gifts-flowers): Cards, flowers, jewellery and experience gifts
- [Hobbies & books](https://promomagpie.com/nz/categories/hobbies-books): Books, crafts and things to make and do

## Guides

- [OCR held at 2.75% by a 4-3 vote: what the 9 December decision could mean for your mortgage](https://promomagpie.com/nz/news/ocr-held-2-75-next-decision-9-december-nz): The Reserve Bank kept the Official Cash Rate at 2.75% on 28 October, but said tighter policy is likely. The next decision is on 9 December.…
- [Warranty ran out after 12 months? The Consumer Guarantees Act can still cover you](https://promomagpie.com/nz/news/consumer-guarantees-act-faulty-goods-warranty-nz): A one-year warranty isn't the limit of your rights. Under the Consumer Guarantees Act, goods must last a reasonable time, and the shop has t…
- [Store spotlights](https://promomagpie.com/nz/stores/spotlights): shops worth a look, with real products and prices

## About

- [Affiliate disclosure](https://promomagpie.com/nz/affiliate-disclosure): how we make money
- [About Promo Magpie](https://promomagpie.com/nz/about)

## Optional

- [Sitemap](https://promomagpie.com/nz/sitemap.xml): every page we want found
- [Agent skill: find promo codes](https://promomagpie.com/nz/.well-known/agent-skills/find-promo-codes/SKILL.md)
- [auth.md](https://promomagpie.com/nz/auth.md): agents need no registration or credentials
- [OpenAPI description](https://promomagpie.com/nz/openapi.json): the read-only endpoints above
