{"openapi":"3.0.3","info":{"title":"TheWineTrip API","version":"1.0.0","description":"The only global wine trip planning API. Access 18 wine regions, 45,000+ GPS-mapped wineries, and AI-ready itinerary generation. Free tier: 100 req/day. Pro: $29/mo.","contact":{"name":"TheWineTrip Developers","url":"https://thewinetrip.com/developers"}},"servers":[{"url":"https://thewinetrip.com/api/v1","description":"Production"}],"paths":{"/regions-list":{"get":{"summary":"List all regions","description":"Returns all 18 wine regions with slug, name, country, and winery count.","operationId":"listRegions","tags":["Regions"],"responses":{"200":{"description":"Array of region summaries","content":{"application/json":{"schema":{"type":"object","properties":{"regions":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","example":"napa"},"name":{"type":"string","example":"Napa Valley"},"country":{"type":"string","example":"USA"},"winery_count":{"type":"integer","example":1188}}}}}}}}}}}},"/regions/{slug}":{"get":{"summary":"Get region guide","description":"Full region data: climate, wine styles, highlights, best months, budget, affiliate hotel/tour links.","operationId":"getRegion","tags":["Regions"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["napa","bordeaux","tuscany","rioja","barossa","champagne","burgundy","douro","mendoza","willamette","alsace","mosel","priorat","rioja-alta","mclaren-vale","hunter-valley","stellenbosch","wachau"]},"description":"Region slug"}],"responses":{"200":{"description":"Region guide data","content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"object"},"affiliate":{"type":"object"}}}}}},"404":{"description":"Region not found"}}}},"/wineries":{"get":{"summary":"Search wineries","description":"Search GPS-mapped wineries by region. 45,000+ records from the alphadev-travel database.","operationId":"getWineries","tags":["Wineries"],"parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string","example":"napa"},"description":"Region slug"},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Search by winery name (optional)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"Winery list with GPS coordinates","content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"object"},"wineries":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}}}}}}}}},"/plan":{"post":{"summary":"Generate itinerary","description":"AI-powered day-by-day wine trip itinerary. Returns structured JSON with daily stops, winery recommendations, and affiliate accommodation/tour links.","operationId":"generateItinerary","tags":["Itinerary"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["region","days"],"properties":{"region":{"type":"string","example":"napa","description":"Region slug"},"days":{"type":"integer","minimum":2,"maximum":10,"example":3},"style":{"type":"string","enum":["romantic","serious","budget","luxury"],"default":"romantic"},"interests":{"type":"array","items":{"type":"string"},"example":["food pairing","architecture"]}}}}}},"responses":{"200":{"description":"Day-by-day itinerary with affiliate links","content":{"application/json":{"schema":{"type":"object","properties":{"itinerary":{"type":"object"},"affiliate":{"type":"object"}}}}}},"400":{"description":"Invalid request parameters"}}}}},"tags":[{"name":"Regions","description":"18 global wine regions"},{"name":"Wineries","description":"GPS-mapped winery database"},{"name":"Itinerary","description":"AI trip planning"}]}