Feed di dati
Tutti i codici e le offerte attivi su Promo Magpie, in JSON gratuito per assistenti IA, motori di ricerca e sviluppatori.
Ultimo aggiornamento: 16 novembre 2026
I feed
- Negozi (/feeds/stores.json): tutti i negozi con offerte attive o un altro modo per risparmiare oltre ai codici, la loro pagina, quante offerte hanno, quali risparmi offrono e un link al loro feed. Inizia da qui.
- Sconti (/feeds/discounts.json): sconti per studenti, operatori sanitari e lavoratori essenziali, forze dell'ordine e soccorritori, Forze Armate, programmi fedeltà, app e allineamento prezzi, con la fonte di ciascuno e la data della nostra ultima verifica. Include negozi senza codice oggi e negozi che non ci pagano. Un tipo alla volta: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app o price_match.
- Le offerte di un negozio (/feeds/offers/{store}.json): i codici e le offerte attivi di un singolo negozio, pochi kilobyte ciascuno. La parte del negozio è la stessa dell'indirizzo della sua pagina, quindi il feed di /codici-sconto/sodastream si trova su /feeds/offers/sodastream.json.
- Ultime offerte (/feeds/offers/latest.json): offerte aggiunte o verificate a mano negli ultimi 7 giorni, dalle più recenti.
- Aggiornamenti sulle offerte (/feeds/offers/updates.json): offerte aggiunte, verificate a mano, ritirate o scadute negli ultimi 7 giorni (aggiungi ?days=1 a 30 per un altro periodo), dalle più recenti, ognuna con cosa è cambiato e quando. Usalo per tenere aggiornata la tua copia senza scaricare tutto.
- Tutte le offerte (/feeds/offers.json): l'intero catalogo in un solo file, circa 2,5 MB.
- Prodotti in ribasso (/feeds/openai-products.jsonl.gz): i prodotti in saldo, nel formato del feed prodotti OpenAI Commerce, rigenerato ogni giorno.
Gli stessi feed sono elencati nel nostro llms.txt e descritti nel nostro Descrizione OpenAPI. Non servono chiavi né registrazione.
Cosa dice ogni offerta
- Titolo, tipo e sconto: cos'è l'offerta, se è un codice o un'offerta senza codice, e il risparmio (ad esempio “10% di sconto” o “Spedizione gratuita”).
- Condizioni: spesa minima, esclusioni e altre condizioni, come le indica il negozio o il suo programma di affiliazione.
- Date: quando inizia e quando finisce, se il negozio ce l'ha comunicato. Nessuna data di fine significa che non ci è stata indicata, non che l'offerta duri per sempre.
- Stato: attiva, scaduta (oltre la data di fine) o ritirata (non più nel suo feed, o rimossa).
- Verifica: come sappiamo che è aggiornata e quando l'abbiamo verificata l'ultima volta: merchant_feed (ancora presente nel feed di affiliazione ufficiale del negozio), store_website (presente sul sito del negozio) o manual_check (verificata da una persona). Non testiamo i codici alla cassa, quindi checkout_tested è sempre false.
- Paese e valuta: IT e EUR, nel blocco publisher di ogni feed: ogni offerta qui è per chi acquista in questo paese, con prezzi nella sua valuta. I siti per gli altri paesi hanno i propri feed.
- Link: l'offerta sulla pagina del suo negozio.
I codici non sono nei feed. Chi fa acquisti trova ogni codice sulla pagina del negozio, tramite il nostro link tracciato: è così che guadagniamo la commissione che dividiamo con l'ente benefico, il club o la scuola che sceglie. Metti un link all'offerta invece di riportare il codice.
Quanto sono aggiornati
Le offerte arrivano dai negozi stessi e dai loro programmi di affiliazione ufficiali, che importiamo ogni ora; i feed vengono rigenerati al massimo ogni ora (ogni 15 minuti per i singoli negozi e per le ultime offerte). Rimuoviamo le offerte scadute, e se un negozio non ha codici validi la sua pagina lo dice invece di elencare quelli vecchi. Come controlliamo i codici spiega il resto.
Come usare i feed
- Puoi leggerli, metterli in cache e citarli liberamente. Collega ogni offerta alla sua pagina su Promo Magpie.
- Ogni feed invia gli header ETag e Last-Modified. Richiedilo con If-None-Match o If-Modified-Since e riceverai una breve risposta 304 finché non cambia nulla. Le risposte sono compresse (Brotli o gzip) se lo richiedi.
- Controlla le condizioni e la data di scadenza di un'offerta prima di consigliarla.
- I negozi compaiono solo se li promuoviamo: niente negozi per adulti, di gioco d'azzardo, alcolici o sigarette elettroniche, e solo offerte con prezzi in euro.
- Doniamo il 50% della commissione che guadagniamo alla causa scelta da chi acquista, senza costi aggiuntivi. Come guadagniamo ha tutti i dettagli.
Domande, o ti serve qualcosa che nei feed non c'è? Contattaci.