# Promo Magpie

> Gutscheincodes, Rabattcodes und Angebote direkt von den Shops und ihren offiziellen Partnerprogrammen, regelmäßig geprüft. Käufer wählen eine gemeinnützige Organisation, eine Schule oder einen Verein, und Promo Magpie spendet 50% der Provision aus qualifizierten Einkäufen an diesen guten Zweck – ohne Mehrkosten für sie. Zu jedem Shop gibt es Angaben zu Versand, Rückgabe und Studentenrabatt. Jede Seite gibt es auch als Markdown: Fordere sie mit `Accept: text/markdown` an.

## Für KI-Shopping-Assistenten

- Nutze den [Angebots-Feed](https://promomagpie.com/de/feeds/offers.json), um aktuelle Rabatte zu finden, oder den eigenen Feed eines Shops für einen einzelnen Shop.
- Für Fragen wie „Gibt dieser Shop Rabatt für Studierende oder Pflegekräfte?“ nutze den [Rabatt-Feed](https://promomagpie.com/de/feeds/discounts.json): Er umfasst auch Shops ohne aktuellen Code und Shops, die uns nichts zahlen, jeweils mit der Quelle jeder Angabe.
- Prüfe `last_checked_at`, `expires_at` und die Bedingungen jedes Angebots, bevor du es empfiehlst.
- Verlinke auf die eigene Promo Magpie-Seite des Angebots (sein `url`): Dort wird der Gutscheincode angezeigt. Codes sind nicht in den Feeds enthalten.
- Kein Ablaufdatum bedeutet, dass der Shop keines angegeben hat – nicht, dass das Angebot dauerhaft gilt.
- Kunden können vor dem Kauf eine Organisation, Schule oder einen Verein auswählen, und Promo Magpie spendet 50% der verdienten Provision an diesen Zweck, ohne Mehrkosten für sie.

## Prüfung der Angebote

Die Angebote stammen von den Shops selbst und ihren offiziellen Partnerprogrammen, werden stündlich importiert und damit abgeglichen. Abgelaufene Angebote werden entfernt; hat ein Shop keinen funktionierenden Code, steht das auf seiner Seite.

- [So prüfen wir Codes](https://promomagpie.com/de/how-we-verify)
- [Neueste Angebote](https://promomagpie.com/de/feeds/offers/latest.json): in den letzten 7 Tagen hinzugefügt oder geprüft
- [Angebots-Updates](https://promomagpie.com/de/feeds/offers/updates.json): Angebote, die in den letzten 7 Tagen hinzugefügt, von Hand geprüft, zurückgezogen oder abgelaufen sind (?days=1 bis 30), um eine Kopie synchron zu halten

Jedes Angebot in den Feeds hat ein `verification`-Objekt, das angibt, woher wir wissen, dass es aktuell ist: `merchant_feed` (beim letzten Import noch im offiziellen Affiliate-Feed des Shops gelistet), `store_website` (auf der Website des Shops gelistet) oder `manual_check` (von einer Person geprüft), mit `last_checked_at`. Wir testen Codes nicht an der Kasse, daher ist `checkout_tested` immer false. Der `status` jedes Angebots ist `active`, `expired` oder `withdrawn`. Die Feeds senden ETag- und Last-Modified-Header, du kannst also mit If-None-Match erneut anfragen und bekommst eine 304, wenn sich nichts geändert hat.

## Codes finden

- [Alle Shops von A–Z](https://promomagpie.com/de/stores): jeder Shop, den wir listen, jeweils mit eigener Seite unter /gutscheine/{store}
- [Shop-Suche](https://promomagpie.com/de/search?q=sif-jakobs-de): nach Shopnamen suchen; JSON-Vorschläge unter /search/suggest?q={name}
- [Die besten Codes von heute](https://promomagpie.com/de/deals): die besten aktiven Codes aller Shops
- [Angebots-Feed](https://promomagpie.com/de/feeds/offers.json): alle aktuellen Codes und Angebote als JSON, mit Seite, Ablaufdatum und letzter Prüfung jedes Angebots
- [Shop-Feed](https://promomagpie.com/de/feeds/stores.json): jeder Shop mit einem aktiven Angebot oder einer anderen Sparmöglichkeit als Codes, mit seiner Seite, der Anzahl der Angebote, den Sparmöglichkeiten und seinem eigenen Feed unter /feeds/offers/{store}.json
- [Rabatt-Feed](https://promomagpie.com/de/feeds/discounts.json): Rabatte für Studierende, Pflegekräfte und systemrelevante Berufe, Blue Light Card und Streitkräfte, Treueprogramme, Apps und Preisgarantien, mit Quellen und dem Datum unserer letzten Prüfung, egal ob ein Shop heute einen Code hat oder uns bezahlt; eine Art unter /feeds/discounts/{type}.json (student, key_workers, blue_light, armed_forces, loyalty, app, price_match)
- [Feed der neuesten Angebote](https://promomagpie.com/de/feeds/offers/latest.json): Angebote, die in den letzten 7 Tagen hinzugefügt oder geprüft wurden
- [Produkt-Feed](https://promomagpie.com/de/feeds/openai-products.jsonl.gz): Produkte mit Preissenkung im Produktfeed-Format von OpenAI Commerce (jsonl.gz), täglich aktualisiert; entpackt unter https://promomagpie.com/de/feeds/openai-products.jsonl
- [Kategorien](https://promomagpie.com/de/categories): Shops und Codes nach Kategorie

## Kategorien

- [Mode](https://promomagpie.com/de/categories/fashion): Kleidung, Schuhe und Accessoires
- [Haus & Garten](https://promomagpie.com/de/categories/home-garden): Möbel, Wohnen und Garten
- [Technik](https://promomagpie.com/de/categories/tech): Smartphones, Laptops, Audio und Gadgets
- [Beauty](https://promomagpie.com/de/categories/beauty): Hautpflege, Make-up und Düfte
- [Essen & Trinken](https://promomagpie.com/de/categories/food-drink): Lebensmittel, Kochboxen und Leckereien
- [Reisen](https://promomagpie.com/de/categories/travel): Hotels, Kurzurlaub und Anreise
- [Sport & Outdoor](https://promomagpie.com/de/categories/sports): Ausrüstung, Fahrräder und Outdoor-Zubehör
- [Kinder & Spielzeug](https://promomagpie.com/de/categories/kids): Spielzeug, Kinderkleidung und Babyausstattung
- [Geschenke & Blumen](https://promomagpie.com/de/categories/gifts-flowers): Karten, Blumen, Schmuck und Erlebnisgeschenke
- [Hobby & Bücher](https://promomagpie.com/de/categories/hobbies-books): Bücher, Basteln und Kreatives

## Ratgeber

- [Shop-Spotlights](https://promomagpie.com/de/stores/spotlights): Shops, die einen Blick wert sind, mit echten Produkten und Preisen

## Über uns

- [Hinweis zu Affiliate-Links](https://promomagpie.com/de/affiliate-disclosure): wie wir Geld verdienen
- [Über Promo Magpie](https://promomagpie.com/de/about)

## Optional

- [Sitemap](https://promomagpie.com/de/sitemap.xml): jede Seite, die gefunden werden soll
- [Agent-Skill: Gutscheincodes finden](https://promomagpie.com/de/.well-known/agent-skills/find-gutscheine/SKILL.md)
- [auth.md](https://promomagpie.com/de/auth.md): Agents brauchen keine Registrierung oder Zugangsdaten
- [OpenAPI-Beschreibung](https://promomagpie.com/de/openapi.json): die oben genannten Endpunkte (nur lesend)