{"openapi":"3.1.0","info":{"title":"Promo Magpie","version":"1.0.0","description":"Accès en lecture seule aux codes promo et offres de Promo Magpie. Aucune clé nécessaire. Merci de renvoyer les utilisateurs vers les pages des boutiques pour les codes, plutôt que de les copier."},"servers":[{"url":"https://promomagpie.com/fr"}],"paths":{"/search/suggest":{"get":{"operationId":"searchStores","summary":"Find stores (and guides) by name","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"PetCareSupplies"}],"responses":{"200":{"description":"Matches, stores first","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["store","guide"]},"label":{"type":"string"},"url":{"type":"string","format":"uri"},"meta":{"type":"string","description":"e.g. \"7 codes & deals\""}}}}}}}}}}}},"/codes-promo/{store}":{"get":{"operationId":"getStoreOffers","summary":"A store's live codes and deals, delivery, returns and student discount details","description":"Send Accept: text/markdown for Markdown; browsers get HTML.","parameters":[{"name":"store","in":"path","required":true,"schema":{"type":"string"},"example":"pet-care-supplies-fr"}],"responses":{"200":{"description":"The store page","content":{"text/markdown":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}}}},"404":{"description":"No such store"}}}},"/news/{article}":{"get":{"operationId":"getArticle","summary":"A money-saving guide or store spotlight","description":"Send Accept: text/markdown for Markdown.","parameters":[{"name":"article","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The article","content":{"text/markdown":{"schema":{"type":"string"}},"text/html":{"schema":{"type":"string"}}}},"404":{"description":"No such article"}}}},"/feeds/stores.json":{"get":{"operationId":"listStores","summary":"Every store with a live offer or a way to save besides codes, with its offer count, saving types and feed","responses":{"200":{"description":"Stores","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/feeds/discounts.json":{"get":{"operationId":"listDiscounts","summary":"Stores with student, NHS and key worker, Blue Light Card or armed forces discounts, loyalty schemes, apps or price matching, whether or not they have a code or pay us","responses":{"200":{"description":"Stores with their savings, sources and when we last reviewed them","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/feeds/discounts/{type}.json":{"get":{"operationId":"listDiscountsOfType","summary":"Stores with one kind of saving","parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["student","key_workers","blue_light","armed_forces","loyalty","app","price_match"]}}],"responses":{"200":{"description":"Stores","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No such type"}}}},"/feeds/offers/updates.json":{"get":{"operationId":"listOfferUpdates","summary":"Offers added, checked by hand, withdrawn or expired recently, newest first","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":30,"default":7}}],"responses":{"200":{"description":"Changes, each with change (added, verified, withdrawn or expired), changed_at and the offer","content":{"application/json":{"schema":{"type":"object"}}}},"304":{"description":"Not changed since your copy (If-None-Match / If-Modified-Since)"}}}},"/feeds/offers/latest.json":{"get":{"operationId":"listLatestOffers","summary":"Offers added or verified in the last 7 days","responses":{"200":{"description":"Offers, newest first","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/feeds/offers/{store}.json":{"get":{"operationId":"getStoreOffersFeed","summary":"One store's live codes and deals as JSON","parameters":[{"name":"store","in":"path","required":true,"schema":{"type":"string"},"example":"pet-care-supplies-fr"}],"responses":{"200":{"description":"The store and its offers","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No such store, or none of its offers are live"}}}},"/feeds/offers.json":{"get":{"operationId":"listOffers","summary":"Every live code and deal, by store","description":"Refreshed hourly. Codes are not included: send shoppers to each offer url, where the code is shown.","responses":{"200":{"description":"Stores with their live offers","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/llms.txt":{"get":{"operationId":"getSiteGuide","summary":"Guide to the site for AI agents","responses":{"200":{"description":"Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}}}