{"openapi":"3.1.0","info":{"title":"Breweries API","version":"1.0.0","description":"Search, filter and locate breweries worldwide — a fast, clean wrapper over Open Brewery DB covering thousands of breweries across the US and beyond. Filter by city, state, country, name, postal code or brewery type (micro, nano, regional, brewpub, large, bar, contract and more), sort results nearest-first from any latitude/longitude, autocomplete brewery names for typeahead, pull random breweries, fetch a single brewery by id and read aggregate counts. Every endpoint accepts input via the query string or the request body and returns lean, predictable JSON with normalized address, coordinates, phone and website fields. Ideal for beer and travel apps, store locators, maps and directory features.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/beer-api","description":"oanor gateway"}],"tags":[{"name":"Breweries"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/autocomplete":{"get":{"operationId":"get_v1_autocomplete","tags":["Breweries"],"summary":"Autocomplete brewery names","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Partial name","schema":{"type":"string"},"example":"dog"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/brewery":{"get":{"operationId":"get_v1_brewery","tags":["Breweries"],"summary":"Single brewery by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Brewery UUID","schema":{"type":"string"},"example":"5128df48-79fc-4f0f-8b52-d06be54d0cec"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Breweries"],"summary":"Aggregate counts","description":"","parameters":[{"name":"by_country","in":"query","required":false,"description":"Country","schema":{"type":"string"},"example":"united states"},{"name":"by_state","in":"query","required":false,"description":"State","schema":{"type":"string"},"example":"california"},{"name":"by_type","in":"query","required":false,"description":"Type","schema":{"type":"string"},"example":"micro"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Breweries"],"summary":"Random breweries","description":"","parameters":[{"name":"size","in":"query","required":false,"description":"1..10 (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Breweries"],"summary":"Search & filter breweries","description":"","parameters":[{"name":"by_city","in":"query","required":false,"description":"City","schema":{"type":"string"},"example":"san diego"},{"name":"by_state","in":"query","required":false,"description":"State/province","schema":{"type":"string"},"example":"california"},{"name":"by_country","in":"query","required":false,"description":"Country","schema":{"type":"string"},"example":"united states"},{"name":"by_type","in":"query","required":false,"description":"micro|nano|regional|brewpub|large|bar|contract|...","schema":{"type":"string"},"example":"micro"},{"name":"by_name","in":"query","required":false,"description":"Name contains","schema":{"type":"string"},"example":"dog"},{"name":"lat","in":"query","required":false,"description":"Latitude for nearest-first","schema":{"type":"string"},"example":"32.71"},{"name":"lon","in":"query","required":false,"description":"Longitude for nearest-first","schema":{"type":"string"},"example":"-117.16"},{"name":"per_page","in":"query","required":false,"description":"1..50 (default 15)","schema":{"type":"string"},"example":"15"},{"name":"page","in":"query","required":false,"description":"Page","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":400,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1200,"monthly_call_quota":800000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3500,"monthly_call_quota":4000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/beer-api"}