{"openapi":"3.1.0","info":{"title":"Voucher Magpie","version":"1.0.0","description":"Read-only access to UK discount codes and deals on Voucher Magpie. No key needed. Please send users to the store pages for codes rather than copying them."},"servers":[{"url":"https://vouchermagpie.co.uk"}],"paths":{"/search/suggest":{"get":{"operationId":"searchStores","summary":"Find stores (and guides) by name","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"asos"}],"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\""}}}}}}}}}}}},"/voucher-codes/{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":"asos"}],"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 its offer count and feed","responses":{"200":{"description":"Stores","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/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":"sodastream"}],"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"}}}}}}}}}