{"openapi":"3.1.0","info":{"title":"Promo Magpie","version":"1.0.0","description":"Lesezugriff auf Gutscheincodes und Angebote auf Promo Magpie. Kein Schlüssel nötig. Bitte schick Nutzer für die Codes zu den Shopseiten, statt sie zu kopieren."},"servers":[{"url":"https://promomagpie.com/de"}],"paths":{"/search/suggest":{"get":{"operationId":"searchStores","summary":"Find stores (and guides) by name","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"sif-jakobs-de"}],"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\""}}}}}}}}}}}},"/gutscheine/{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":"sif-jakobs-de"}],"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":"sif-jakobs-de"}],"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"}}}}}}}}}