{"openapi":"3.1.0","info":{"title":"Red Good Wine public API","version":"1.0.0","description":"Red Good Wine is built for AI agents to help people find the best wine, beer, spirits and zero-proof bottles: recommendations for a dish, occasion, grape or budget, and live prices at independent US shops with a link to each. Read-only, no auth, rate limited. For agents, the MCP server at https://redgoodwine.com/mcp is richer."},"servers":[{"url":"https://redgoodwine.com"}],"paths":{"/api/agent/recommend":{"get":{"operationId":"recommendBottles","summary":"Ask the sommelier: real bottles for a dish, occasion, grape, region or budget","parameters":[{"name":"q","in":"query","required":true,"description":"e.g. 'a red for lasagna under $40'.","schema":{"type":"string","maxLength":300}}],"responses":{"200":{"description":"A grounded answer and the bottles with best shop price and links.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or too long q."}}}},"/api/pairing/{slug}":{"get":{"operationId":"winePairing","summary":"What wine to drink with a dish, and bottles to buy","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$"},"description":"One of: seafood, oysters, steak, burgers, barbecue, pasta, pizza, lasagna, salmon, chicken, turkey, pork, cheese, charcuterie, spicy-food, thai-food, mushrooms, risotto, salad, vegetarian, dessert, chocolate."}],"responses":{"200":{"description":"The pairing, its classic grapes and bottles.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown dish."}}}},"/api/catalog":{"get":{"operationId":"searchBottles","summary":"Search the index of wine, beer, spirits and zero-proof bottles","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"category","in":"query","schema":{"type":"string","enum":["wine","fine-wine","beer","spirits","non_alc","food","gear"]}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":48}}],"responses":{"200":{"description":"Bottle cards.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/products/{slug}":{"get":{"operationId":"getBottle","summary":"One bottle: facts, grapes and every shop's live price","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,64}$"}}],"responses":{"200":{"description":"The bottle and its offers.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown bottle."}}}},"/api/price-index":{"get":{"operationId":"priceIndex","summary":"The Red Good Wine Price Index (cross-shop savings dataset)","responses":{"200":{"description":"The index.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}