Aller au contenu

Flux de données

Tous les codes et offres en cours sur Promo Magpie, en JSON gratuit pour les assistants IA, les moteurs de recherche et les développeurs.

Dernière mise à jour : 16 novembre 2026

Les flux

  • Boutiques (/feeds/stores.json): toutes les boutiques avec des offres en cours ou un autre moyen d'économiser que les codes, leur page, leur nombre d'offres, les économies proposées et un lien vers leur propre flux. Commencez ici.
  • Réductions (/feeds/discounts.json): réductions pour les étudiants, les personnels soignants et métiers essentiels, les secours et les militaires, programmes de fidélité, applis et alignement de prix, avec la source de chacune et la date de notre dernière vérification. Cela inclut les boutiques sans code aujourd'hui et celles qui ne nous rémunèrent pas. Un type à la fois : /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app ou price_match.
  • Les offres d'une boutique (/feeds/offers/{store}.json): les codes et offres en cours d'une seule boutique, quelques kilo-octets chacun. La partie boutique reprend l'adresse de sa page : le flux de /codes-promo/sodastream se trouve donc à /feeds/offers/sodastream.json.
  • Dernières offres (/feeds/offers/latest.json): offres ajoutées ou vérifiées à la main ces 7 derniers jours, les plus récentes d'abord.
  • Nouveautés des offres (/feeds/offers/updates.json): offres ajoutées, vérifiées à la main, retirées ou expirées ces 7 derniers jours (ajoutez ?days=1 à 30 pour une autre période), les plus récentes d'abord, chacune avec ce qui a changé et quand. Utilisez-le pour garder votre copie à jour sans tout télécharger.
  • Toutes les offres (/feeds/offers.json): tout le catalogue dans un seul fichier, environ 2,5 Mo.
  • Produits en baisse de prix (/feeds/openai-products.jsonl.gz): les produits en promotion, au format de flux produits OpenAI Commerce, régénéré chaque jour.

Les mêmes flux sont listés dans notre llms.txt et décrits dans notre Description OpenAPI. Aucune clé ni inscription n'est nécessaire.

Ce que dit chaque offre

  • Titre, type et réduction : ce qu'est l'offre, s'il s'agit d'un code ou d'une offre sans code, et l'économie (par exemple « 10 % de réduction » ou « Livraison gratuite »).
  • Conditions : minimum d'achat, exclusions et autres conditions, tels que la boutique ou son programme d'affiliation les indiquent.
  • Dates : quand elle commence et se termine, si la boutique nous l'a indiqué. Pas de date de fin signifie qu'aucune n'a été donnée, pas que l'offre dure pour toujours.
  • Statut : active, expirée (date de fin dépassée) ou retirée (plus dans son flux, ou supprimée).
  • Vérification : comment nous savons qu'elle est à jour, et quand nous l'avons vérifiée pour la dernière fois : merchant_feed (toujours présente dans le flux d'affiliation officiel de la boutique), store_website (affichée sur le site de la boutique) ou manual_check (vérifiée par une personne). Nous ne testons pas les codes au moment de payer : checkout_tested vaut donc toujours false.
  • Pays et devise : FR et EUR, dans le bloc éditeur de chaque flux : chaque offre est destinée aux acheteurs de ce pays, avec des prix dans sa devise. Nos sites pour les autres pays ont leurs propres flux.
  • Lien : l'offre sur la page de sa boutique.

Les codes eux-mêmes ne figurent pas dans les flux. Les acheteurs obtiennent chaque code sur la page de la boutique, via notre lien suivi : c'est ainsi que nous touchons la commission que nous partageons avec l'association, le club ou l'école de leur choix. Merci de mettre un lien vers l'offre plutôt que de citer le code.

Fraîcheur des données

Les offres viennent des boutiques elles-mêmes et de leurs programmes d'affiliation officiels, que nous importons toutes les heures ; les flux sont regénérés au plus toutes les heures (toutes les 15 minutes pour chaque boutique et pour les dernières offres). Nous retirons les offres expirées, et quand une boutique n'a pas de code valable, sa page le dit au lieu de lister d'anciens codes. Comment nous vérifions les codes explique le reste.

Utiliser les flux

  • Vous pouvez les lire, les mettre en cache et les citer librement. Merci de lier chaque offre à sa page sur Promo Magpie.
  • Chaque flux envoie les en-têtes ETag et Last-Modified. Redemandez avec If-None-Match ou If-Modified-Since et vous recevrez une courte réponse 304 tant que rien n'a changé. Les réponses sont compressées (Brotli ou gzip) si vous le demandez.
  • Vérifiez les conditions et la date de fin d'une offre avant de la recommander.
  • Les boutiques n'apparaissent que si nous les mettons en avant : pas de boutiques pour adultes, de jeux d'argent, d'alcool ou de vapotage, et uniquement des offres en euros.
  • Nous reversons 50 % de la commission que nous touchons à la cause choisie par l'acheteur, sans aucun coût supplémentaire pour lui. Comment nous gagnons de l'argent donne le détail.

Une question, ou besoin de quelque chose qui n'est pas dans les flux ? Nous contacter.

Choisissez une association ou un club à soutenir · nous lui reversons 50 % de notre commission, sans frais pour vousChoisir