{"openapi":"3.1.0","info":{"title":"Yemshik API","version":"1.0.0","description":"Public discovery API for Yemshik verified coupon search, store catalog, and Riyadh dialect retail intelligence."},"servers":[{"url":"https://yemshik.com"}],"paths":{"/health":{"get":{"summary":"Health Check","responses":{"200":{"description":"Service health status"}}}},"/api/stores/{id}/coupons":{"get":{"summary":"List verified coupons for a store","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":15}}],"responses":{"200":{"description":"Paginated list of active coupons"}}}},"/stores":{"get":{"summary":"Search stores directory","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Stores directory with pagination"}}}},"/go/{id}":{"get":{"summary":"Outbound tracking redirect to merchant","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect to merchant website"}}}}}}