Skoči na vsebino

Viri podatkov

Vse veljavne kode in akcije z Promo Magpie kot brezplačen JSON za pomočnike z umetno inteligenco, iskalnike in razvijalce.

Nazadnje posodobljeno 17. novembra 2026

Viri podatkov

  • Trgovine (/feeds/stores.json): vse trgovine z aktualnimi ponudbami ali drugim načinom varčevanja poleg kod, njihova stran, število ponudb, vrste prihrankov in povezava do lastnega vira. Začnite tukaj.
  • Popusti (/feeds/discounts.json): popusti za študente, zdravstvene delavce in ljudi v ključnih poklicih, gasilce, reševalce in policiste ter vojake, programi zvestobe, aplikacije in zagotovila najnižje cene, pri vsakem, od kod izvira in kdaj smo ga nazadnje pregledali. Vključuje tudi trgovine, ki danes nimajo kode, in trgovine, ki nam ne plačujejo. Po ena vrsta naenkrat: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app ali price_match.
  • Ponudbe ene trgovine (/feeds/offers/{store}.json): aktualne kode in akcije posamezne trgovine, vsak po nekaj kilobajtov. Del s trgovino je enak naslovu njene strani, zato ima /kode-za-popust/sodastream svoj vir na /feeds/offers/sodastream.json.
  • Najnovejše ponudbe (/feeds/offers/latest.json): ponudbe, dodane ali ročno preverjene v zadnjih 7 dneh, od najnovejših.
  • Novosti v ponudbah (/feeds/offers/updates.json): ponudbe, dodane, ročno preverjene, umaknjene ali potekle v zadnjih 7 dneh (za drugo obdobje dodajte ?days=1 do 30), od najnovejših, pri vsaki, kaj se je spremenilo in kdaj. Tako ohranite svojo kopijo ažurno, ne da bi morali vse prenesti znova.
  • Vse ponudbe (/feeds/offers.json): celoten katalog v eni datoteki, približno 2,5 MB.
  • Izdelki z znižano ceno (/feeds/openai-products.jsonl.gz): znižani izdelki v obliki produktnega vira OpenAI Commerce, posodobljeni vsak dan.

Isti viri so navedeni tudi v llms.txt in opisani v Opis OpenAPI. Ključ ali registracija nista potrebna.

Kaj piše v posamezni ponudbi

  • Naslov, vrsta in popust: za kakšno ponudbo gre, ali je koda ali akcija, in kakšen je prihranek (na primer »10 % popusta« ali »Brezplačna dostava«).
  • Pogoji: najnižji znesek nakupa, izjeme in drugi pogoji, kot jih navaja trgovina ali njen partnerski program.
  • Datumi: kdaj se začne in konča, če nam je trgovina to sporočila. Če datuma konca ni, ga nihče ni navedel, kar ne pomeni, da ponudba velja za vedno.
  • Stanje: aktivna, potekla (po datumu izteka) ali umaknjena (je ni več v viru ali je bila odstranjena).
  • Preverjanje: kako vemo, da je aktualna, in kdaj smo jo nazadnje preverili: merchant_feed (še vedno navedena v uradnem partnerskem viru trgovine), store_website (navedena na spletni strani trgovine same) ali manual_check (preveril jo je človek). Kod na blagajni ne preizkušamo, zato je checkout_tested vedno false.
  • Država in valuta: SI in EUR v bloku izdajatelja vsakega vira: vsaka ponudba tukaj je namenjena kupcem v tej državi, s cenami v njeni valuti. Naše spletne strani za druge države imajo svoje vire.
  • Povezava: ponudba na strani trgovine.

Samih kod v virih podatkov ni. Kupci vsako kodo dobijo na strani trgovine prek naše sledene povezave – tako zaslužimo provizijo, ki jo delimo z dobrodelno organizacijo, klubom ali šolo, ki so jo izbrali. Prosimo, povežite na ponudbo, namesto da kodo navedete neposredno.

Kako sveži so podatki

Ponudbe prihajajo neposredno od trgovin in iz njihovih uradnih partnerskih programov, ki jih uvažamo vsako uro; viri se obnovijo največ enkrat na uro (za posamezne trgovine in najnovejše ponudbe vsakih 15 minut). Potekle ponudbe odstranimo, in če trgovina nima delujoče kode, to piše na njeni strani, namesto da bi prikazovala stare. Kako preverjamo kode pojasni ostalo.

Uporaba virov podatkov

  • Lahko jih berete, shranjujete v predpomnilnik in citirate. Prosimo, da vsako ponudbo povežete z njeno stranjo na Promo Magpie.
  • Vsak vir pošilja glavi ETag in Last-Modified. Znova vprašajte z If-None-Match ali If-Modified-Since in dokler se nič ne spremeni, dobite kratek odgovor 304. Če to zahtevate, so odgovori stisnjeni (Brotli ali gzip).
  • Preden ponudbo priporočite, preverite njene pogoje in datum izteka.
  • Trgovine se prikažejo samo, če jih promoviramo: brez trgovin za odrasle, iger na srečo, alkohola ali e-cigaret in samo ponudbe s cenami v evrih.
  • 50 % provizije, ki jo zaslužimo, podarimo prejemniku, ki ga izbere kupec, brez dodatnih stroškov zanj. Podrobnosti: Kako zaslužimo.

Imate vprašanja ali potrebujete nekaj, česar v virih ni? Pišite nam.

Izberite dobrodelno organizacijo ali klub, ki ga želite podpreti · podarimo 50 % naše provizije, brez stroškov za vasIzberi