{"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","content":{"application/json":{"example":{"data":{"count":50,"query":"dog","results":[{"id":"78c50e54-34e3-415d-9574-ac0cc0505113","name":"Dog & Pony Alehouse and Grill"},{"id":"b29882fe-e037-4e4a-a164-eb76723893ac","name":"Dog and Pony Brewing Company"},{"id":"c27f55b4-f410-4389-ae35-a5a9bada3578","name":"Dog Days Brewing"},{"id":"e4054c02-8992-4c0c-8954-89f0d6ebaead","name":"Dog Tag Brewing"},{"id":"e7663a51-2d14-4e31-b52b-a3cd846fd19a","name":"Dog Money Restaurant"},{"id":"fe4c36a3-d900-46b0-b445-a4f951b9f7e2","name":"Dog Rose Brewing Company"},{"id":"281e6980-e2e2-4493-9896-3517e8cafe21","name":"Dogfish Head Craft Brewery"},{"id":"7a6bd1cf-4385-4677-a9d7-3507535399e4","name":"Dogfish Head Brewings & Eats"},{"id":"9144058f-df13-47b0-b656-4c4384058085","name":"DogBerry Brewing LLC"},{"id":"b391b3db-33bf-47d4-8878-ab3f8b610bde","name":"Dogtown Brewing"},{"id":"c117151a-0efe-4a7a-bbab-ce130ffc2f08","name":"Doghaus Brewery"},{"id":"0ab3dca4-244e-4efd-bf34-92687747499a","name":"Wet Dog Cafe & Brewery"},{"id":"0f0ea92d-3acc-4f59-bb72-2e6cb404bc6a","name":"Little Dog Brewing Co."},{"id":"1799d0b2-7266-4ad9-a3ca-15cc2e3bf833","name":"Old Dog Alehouse & Brewery"},{"id":"189df38b-d6a6-40c0-917e-5b172be8d859","name":"Sea Dog Brewing"},{"id":"2907b143-57b4-49ec-aa41-07df64d1e14b","name":"Barrel Dog Brewing"},{"id":"2c048f27-d9fc-4117-ae9a-c3c79ea2470e","name":"Big Dog's Brewing Co"},{"id":"2c797daa-c0a9-4a75-86b0-ed59a6a78b52","name":"PUB DOG Brewing Company"},{"id":"2ebb8fea-f982-43a0-bc95-b0ac01ae3f99","name":"Bike Dog Brewing Co"},{"id":"350f58c9-f1e6-4668-bf55-15dc557ec94c","name":"Dreaming Dog Brewery"},{"id":"3a6986ab-3cfc-4301-9689-aff66afb46d7","name":"Thirsty Dog Brewing Company"},{"id":"45e0fb3d-250a-43b5-97c7-12bffc42e14e","name":"Moon Dog Craft Brewery"},{"id":"5a534132-ae7b-462d-b58e-58e7c2d3e785","name":"Black Dog Brewing Co"},{"id":"7c6bc6c6-dd61-41a6-b794-6a1f742c0ebb","name":"Lead Dog Brewing"},{"id":"85958926-717c-4fd4-a9b1-b57958058c21","name":"Sea Dog Brewing Co - S. Portland"},{"id":"88888d5b-1553-4773-806c-4b844a34b996","name":"Red Dog Brewery"},{"id":"8b52fa56-8b17-4ed8-b670-0bd3c4b39c2d","name":"Tin Dog Brewing"},{"id":"940212f2-d8e3-4f7d-9a7a-8f89b7a3edd2","name":"Spotty Dog Brewery"},{"id":"9d64f11c-4f42-41c6-8ba7-768f7bf9ec13","name":"Alpine Dog Brewing Co"},{"id":"a2bdb22b-3649-43a7-85b8-7821e09c1d7c","name":"Sleepy Dog Brewing Co"},{"id":"a573715c-9468-4d3f-b90c-4c5754e87531","name":"Sea Dog Brewing Co"},{"id":"abcd1ceb-8283-4d5f-aeb9-bda3778067c7","name":"Trail Dog Brewing Co."},{"id":"b4835825-07a9-4210-b648-e796a460a11d","name":"White Dog Brewing Boise"},{"id":"ba89a4c2-b9c9-4653-bbf1-8bf419c7c5ec","name":"Yellow Dog Brewing Company - Port Moody"},{"id":"bf11197a-a50f-4bb6-af48-0719c009eed6","name":"White Dog Brewing Company"},{"id":"bf3c0dbf-53cf-40d9-906a-baf2a57bc0a6","name":"Sea Dog Brewing Co - Clearwater"},{"id":"d4dc69ab-cf58-44b9-9456-cea49cf6dd35","name":"Boss Dog Brewing"},{"id":"d6accc58-89f9-43fd-bb06-e87a48ed9f2c","name":"Sea Dog Brewing Co - Bangor"},{"id":"d6dbff7d-aba1-4ff4-8c87-4aa479bbb8fb","name":"River Dog Brewing Co"},{"id":"d9640321-8cf9-41bd-aeb8-9a2163e23f42","name":"Dingo Dog Brewing Co"},{"id":"e1857ee0-3547-4b8d-82f9-b146e0510014","name":"Yellow Dog Brewing Company - Penticton"},{"id":"e2b339ba-8984-497a-ba6b-91882dec1515","name":"Flying Dog Brewery"},{"id":"e4c8261f-0f96-4951-81a6-667166ce4586","name":"Laughing Dog Brewing"},{"id":"e57d55f3-ee8c-45b0-a092-c77def6cd561","name":"Triple Dog Brewing Company"},{"id":"ecb3dc09-11f9-4844-8cac-83340856e42d","name":"Diving Dog Brewhouse"},{"id":"f8c5522b-6ccf-44ff-86b4-92498df8a9a5","name":"Spotted Dog Brewery"},{"id":"fa2fde2e-51da-470a-a151-ce76e6d529b3","name":"Island Dog Brewing"},{"id":"0759476d-8fed-46cc-abec-1cb02cbca0d6","name":"Running Dogs Brewery"},{"id":"36b10736-7d32-4ff4-bb48-93297fb2603d","name":"Hop Dogma Brewing Company"},{"id":"7afa7b01-585a-45e5-9d68-843617aa592e","name":"Redgarden Brewery"}]},"meta":{"timestamp":"2026-05-30T22:48:43.503Z","request_id":"e085768d-3454-4883-8516-2e27b10a5477"},"status":"ok","message":"Autocomplete completed","success":true}}}},"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","content":{"application/json":{"example":{"data":{"id":"5128df48-79fc-4f0f-8b52-d06be54d0cec","city":"Norman","name":"(405) Brewing Co","type":"micro","phone":"4058160490","state":"Oklahoma","street":"1716 Topeka St","country":"United States","latitude":35.25738891,"longitude":-97.46818222,"postal_code":"73069-8224","website_url":"http://www.405brewing.com"},"meta":{"timestamp":"2026-05-30T22:48:43.600Z","request_id":"72f4ab8c-9ae2-4482-8dff-92325f73fee8"},"status":"ok","message":"Brewery retrieved","success":true}}}},"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","content":{"application/json":{"example":{"data":{"page":1,"total":466,"per_page":50},"meta":{"timestamp":"2026-05-30T22:48:44.243Z","request_id":"91e24b78-ce22-4e0c-a658-73dc7309818b"},"status":"ok","message":"Meta retrieved","success":true}}}},"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","content":{"application/json":{"example":{"data":{"count":1,"results":[{"id":"8df1dd63-af4f-4173-805a-3c1c22a4df2d","city":"Destin","name":"McGuire's Irish Pub and Brewery - Destin","type":"brewpub","phone":"8506540567","state":"Florida","street":"33 Highway 98 E","country":"United States","postal_code":"32541-2309","website_url":"http://www.mcguiresirishpub.com"}]},"meta":{"timestamp":"2026-05-30T22:48:44.786Z","request_id":"d3795284-d9d9-41ee-bb9e-ca3a6fa0b114"},"status":"ok","message":"Random brewery retrieved","success":true}}}},"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","content":{"application/json":{"example":{"data":{"page":1,"count":0,"filters":{"by_city":"san_diego","by_dist":"32.71,-117.16","by_name":"dog","by_type":"micro","by_state":"california","by_country":"united_states"},"results":[],"per_page":15},"meta":{"timestamp":"2026-05-30T22:48:45.372Z","request_id":"6bd186a2-a353-4097-ad7f-a802575bf7ac"},"status":"ok","message":"Search completed","success":true}}}},"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"}