Datenfeeds

Die Feeds

• Shops (/feeds/stores.json): jeder Shop mit aktiven Angeboten oder einer anderen Sparmöglichkeit als Codes, seine Seite, wie viele Angebote er hat, welche Sparmöglichkeiten es gibt und ein Link zu seinem eigenen Feed. Fang hier an.
• Rabatte (/feeds/discounts.json): Rabatte für Studenten, Gesundheitswesen und systemrelevante Berufe, Blue Light Card und Soldaten, Treueprogramme, Apps und Preisgarantien, jeweils mit Quelle und Datum unserer letzten Prüfung. Enthält auch Shops ohne aktuellen Code und Shops, die uns nichts zahlen. Jeweils eine Art: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app oder price_match.
• Angebote eines Shops (/feeds/offers/{store}.json): die aktiven Codes und Angebote eines einzelnen Shops, je ein paar Kilobyte. Der Shop-Teil entspricht der Adresse seiner Seite, also hat /gutscheine/sodastream seinen Feed unter /feeds/offers/sodastream.json.
• Neueste Angebote (/feeds/offers/latest.json): in den letzten 7 Tagen von Hand hinzugefügte oder geprüfte Angebote, neueste zuerst.
• Angebots-Updates (/feeds/offers/updates.json): Angebote, die in den letzten 7 Tagen hinzugefügt, von Hand geprüft, zurückgezogen wurden oder abgelaufen sind (hänge ?days=1 bis 30 an für einen anderen Zeitraum), neueste zuerst, jeweils mit Angabe, was sich wann geändert hat. Damit hältst du deine eigene Kopie aktuell, ohne alles herunterzuladen.
• Alle Angebote (/feeds/offers.json): der gesamte Katalog in einer Datei, etwa 2,5 MB.
• Produkte mit Preissenkung (/feeds/openai-products.jsonl.gz): reduzierte Produkte im Produktfeed-Format von OpenAI Commerce, täglich neu erstellt.

Dieselben Feeds sind in unserer llms.txt aufgeführt und in unserer OpenAPI-Beschreibung beschrieben. Kein Schlüssel und keine Anmeldung nötig.

Was jedes Angebot enthält

• Titel, Art und Rabatt: was das Angebot ist, ob es ein Code oder ein Deal ist, und die Ersparnis (z. B. „10 % Rabatt“ oder „Kostenloser Versand“).
• Bedingungen: Mindestbestellwert, Ausschlüsse und andere Bedingungen, wie der Shop oder sein Partnerprogramm sie angibt.
• Daten: wann es beginnt und endet, sofern der Shop es uns mitgeteilt hat. Kein Enddatum heißt, dass keins angegeben wurde, nicht dass es ewig läuft.
• Status: aktiv, abgelaufen (Enddatum überschritten) oder zurückgezogen (nicht mehr im Feed oder entfernt).
• Prüfung: woher wir wissen, dass es aktuell ist, und wann wir zuletzt geprüft haben: merchant_feed (noch im offiziellen Affiliate-Feed des Shops gelistet), store_website (auf der Website des Shops gelistet) oder manual_check (von einer Person geprüft). Wir testen Codes nicht an der Kasse, daher ist checkout_tested immer false.
• Land und Währung: DE und EUR, im Publisher-Block jedes Feeds: Jedes Angebot hier gilt für Kunden in diesem Land, mit Preisen in dessen Währung. Unsere Seite für das andere Land hat eigene Feeds.
• Link: das Angebot auf seiner Shopseite.

Die Codes selbst sind nicht in den Feeds. Käufer bekommen jeden Code auf seiner Shopseite über unseren Tracking-Link – so verdienen wir die Provision, die wir mit der Organisation, dem Verein oder der Schule ihrer Wahl teilen. Bitte verlinke auf das Angebot, statt den Code zu zitieren.

Wie aktuell die Daten sind

Die Angebote kommen direkt von den Shops und ihren offiziellen Affiliate-Programmen, die wir stündlich importieren; die Feeds werden höchstens stündlich neu erstellt (alle 15 Minuten für einzelne Shops und die neuesten Angebote). Abgelaufene Angebote nehmen wir heraus, und wenn ein Shop keinen funktionierenden Code hat, steht das auf seiner Seite, statt alte Codes zu listen. So prüfen wir Codes erklärt den Rest.

Die Feeds nutzen

• Du darfst sie gern lesen, zwischenspeichern und zitieren. Bitte verlinke jedes Angebot auf seine Seite bei Promo Magpie.
• Jeder Feed sendet ETag- und Last-Modified-Header. Frag erneut mit If-None-Match oder If-Modified-Since, und du bekommst eine kurze 304-Antwort, bis sich etwas geändert hat. Antworten werden auf Wunsch komprimiert (Brotli oder gzip).
• Prüfe die Bedingungen und das Enddatum eines Angebots, bevor du es empfiehlst.
• Shops erscheinen nur, wenn wir sie bewerben: keine Shops für Erwachsene, Glücksspiel, Alkohol oder Vapes, und nur Angebote mit Preisen in Euro.
• Wir spenden 50% der verdienten Provision an die Organisation, die der Käufer auswählt – ohne Mehrkosten für ihn. Wie wir Geld verdienen enthält die Details.

Fragen, oder brauchst du etwas, das nicht in den Feeds steht? Kontakt aufnehmen.