Datasyötteet
Kaikki Promo Magpie -palvelun voimassa olevat koodit ja tarjoukset ilmaisena JSON-muotona tekoälyavustajille, hakukoneille ja kehittäjille.
Päivitetty viimeksi 16. marraskuuta 2026
Syötteet
- Kaupat (/feeds/stores.json): jokainen kauppa, jolla on voimassa olevia tarjouksia tai muu säästötapa kuin koodi: sen sivu, montako tarjousta sillä on, mitä säästöjä se tarjoaa ja linkki sen omaan syötteeseen. Aloita tästä.
- Alennukset (/feeds/discounts.json): opiskelija-alennukset, hoitoalan ja muiden avainalojen työntekijöiden alennukset, Blue Light Card ja Puolustusvoimien henkilöstön alennukset, kanta-asiakasohjelmat, sovellukset ja hintatakuut, ja jokaisesta lähde ja viimeisimmän tarkistuksemme ajankohta. Mukana on myös kauppoja, joilla ei ole tänään koodia, ja kauppoja, jotka eivät maksa meille. Yksi laji kerrallaan: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app tai price_match.
- Yhden kaupan tarjoukset (/feeds/offers/{store}.json): yksittäisen kaupan voimassa olevat koodit ja tarjoukset, kukin muutaman kilotavun kokoinen. Kauppaosa on sama kuin kaupan sivun osoitteessa, joten kaupan /alennuskoodit/sodastream syöte löytyy osoitteesta /feeds/offers/sodastream.json.
- Uusimmat tarjoukset (/feeds/offers/latest.json): käsin lisätyt tai tarkistetut tarjoukset viimeisen 7 päivän ajalta, uusimmat ensin.
- Tarjouspäivitykset (/feeds/offers/updates.json): viimeisen 7 päivän aikana lisätyt, käsin tarkistetut, poistetut tai vanhentuneet tarjoukset (lisää ?days=1–30, jos haluat muun ajanjakson), uusimmat ensin, ja jokaisesta näkyy, mikä muuttui ja milloin. Näin pidät oman kopiosi ajan tasalla lataamatta kaikkea.
- Kaikki tarjoukset (/feeds/offers.json): koko luettelo yhdessä tiedostossa, noin 2,5 Mt.
- Hinnanalennustuotteet (/feeds/openai-products.jsonl.gz): alennuksessa olevat tuotteet OpenAI Commerce -tuotesyötemuodossa, päivitetään päivittäin.
Samat syötteet on lueteltu tiedostossa llms.txt ja kuvattu tiedostossa OpenAPI-kuvaus. Avainta tai rekisteröitymistä ei tarvita.
Mitä kukin tarjous kertoo
- Otsikko, tyyppi ja alennus: mitä tarjous sisältää, onko se koodi vai tarjous, ja säästö (kuten ”10 % alennus” tai ”Ilmainen toimitus”).
- Ehdot: vähimmäisostos, poikkeukset ja muut ehdot sellaisina kuin kauppa tai sen kumppaniohjelma ne ilmoittaa.
- Päivämäärät: milloin se alkaa ja päättyy, jos kauppa on kertonut sen meille. Jos päättymispäivää ei ole, sitä ei ole ilmoitettu – se ei tarkoita, että tarjous on voimassa ikuisesti.
- Tila: voimassa, vanhentunut (päättymispäivä mennyt) tai poistettu (ei enää syötteessä tai otettu pois).
- Tarkistus: miten tiedämme sen olevan ajan tasalla ja milloin tarkistimme sen viimeksi: merchant_feed (yhä kaupan virallisessa kumppanisyötteessä), store_website (näkyy kaupan omalla sivustolla) tai manual_check (ihmisen tarkistama). Emme testaa koodeja kassalla, joten checkout_tested on aina false.
- Maa ja valuutta: FI ja EUR jokaisen syötteen julkaisijalohkossa: jokainen tarjous täällä on tämän maan ostajille, ja hinnat ovat sen valuutassa. Muiden maiden sivustoillamme on omat syötteensä.
- Linkki: tarjous kaupan sivulla.
Itse koodit eivät ole syötteissä. Ostajat saavat jokaisen koodin sen kaupan sivulta seurantalinkkimme kautta, ja näin ansaitsemme provision, jonka jaamme heidän valitsemansa järjestön, seuran tai koulun kanssa. Linkitä mieluummin tarjoukseen kuin lainaa koodia.
Kuinka tuoretta tieto on
Tarjoukset tulevat suoraan kaupoilta ja niiden virallisista kumppaniohjelmista, jotka tuomme joka tunti; syötteet luodaan uudelleen enintään kerran tunnissa (15 minuutin välein yksittäisten kauppojen ja uusimpien tarjousten osalta). Poistamme vanhentuneet tarjoukset, ja jos kaupalla ei ole toimivaa koodia, sen sivulla kerrotaan siitä sen sijaan, että siellä listattaisiin vanhoja koodeja. Näin tarkistamme koodit kertoo loput.
Syötteiden käyttö
- Saat vapaasti lukea, tallentaa välimuistiin ja lainata niitä. Linkitä kuitenkin jokainen tarjous sen omalle sivulle palvelussa Promo Magpie.
- Jokainen syöte lähettää ETag- ja Last-Modified-otsakkeet. Kun kysyt uudelleen If-None-Match- tai If-Modified-Since-otsakkeella, saat lyhyen 304-vastauksen, kunnes jokin on muuttunut. Vastaukset pakataan (Brotli tai gzip), kun pyydät sitä.
- Tarkista tarjouksen ehdot ja päättymispäivä ennen kuin suosittelet sitä.
- Kaupat näkyvät vain, jos mainostamme niitä: ei aikuisviihde-, uhkapeli-, alkoholi- tai vape-kauppoja, ja vain euromääräiset tarjoukset.
- Lahjoitamme 50 % saamastamme provisiosta ostajan valitsemalle kohteelle ilman lisäkuluja hänelle. Näin ansaitsemme rahaa kertoo yksityiskohdat.
Kysyttävää, tai tarvitsetko jotain, mitä syötteissä ei ole? Ota yhteyttä.