Note: The API is still in BETA and subject to change. If you are planning any production-ready projects, please subscribe to the Newsletter for updates. Thank you!

— Management

## About

Open Brewery DB is a free database and API for public information on breweries, cideries, brewpubs, and bottleshops. Currently it is focused to the United States, but future plans are to import world-wide data.

## Why?

I like craft breweries. I particularly like those which allow my dog, are open during the day, and have WiFi so I can work remote with my best buddy. While there are other websites and resources available, none had an easy-to-use, publically-accessible API.

The goal of this project is to keep an up-to-date, curated, and publically available database of breweries for the betterment of the beer community and joy of web developers like myself.

Cheers! 🍻

## Documentation

Endpoints

List of breweries:

https://api.openbrewerydb.org/breweries
JSON:
[
  ...
  {
    id: 299,
    name: "Almanac Beer Company",
    brewery_type: "micro",
    street: "651B W Tower Ave",
    city: "Alameda",
    state: "California",
    postal_code: "94501-5047",
    country: "United States",
    longitude: "-122.306283180899",
    latitude: "37.7834497667258",
    phone: "4159326531",
    website_url: "http://almanacbeer.com",
    updated_at: "2018-08-23T23:24:11.758Z"
  },
  ...
]
Filter, search, and sort parameters:
  • by_city
    • Case-insensitive
    • Searches in any position
  • by_name
    • Case insensitive
    • Searches in any position
  • by_state
    • Case insensitive
    • Searches in any position
  • by_type
    • Must be one of: micro, regional, brewpub, large, planning, bar, contract, proprietor
    • Case insensitive
    • Exact match
  • sort
    • + for acending order (default order); - for decending order
    • comma-separated
    • Example: sort=-name,+type,city
Filter, search, and sort examples:
Filter breweries by state:
https://api.openbrewerydb.org/breweries?by_state=NY
Filter breweries by name:
https://api.openbrewerydb.org/breweries?by_name=cooper
Filter breweries by name and state:
https://api.openbrewerydb.org/breweries?by_name=cooper&by_state=NY
Filter breweries by state and sort by type then by name in decending order:
https://api.openbrewerydb.org/breweries?by_state=oh&sort=type,-name
Pagination & Per Page (default per page is 20; max per page is 50):
https://api.openbrewerydb.org/breweries?page=2&per_page=30

Get a brewery:

https://api.openbrewerydb.org/breweries/5494
JSON:
{
  id: 5494,
  name: "MadTree Brewing",
  brewery_type: "regional",
  street: "3301 Madison Rd",
  city: "Cincinnati",
  state: "Ohio",
  postal_code: "45209-1132",
  country: "United States",
  longitude: "-84.4239715",
  latitude: "39.1563725",
  phone: "5138368733",
  website_url: "http://www.madtreebrewing.com",
  updated_at: "2018-08-24T15:44:22.281Z"
}

Autocomplete:

https://api.openbrewerydb.org/breweries/autocomplete?query=dog
JSON:
[
  {
    id: "4263",
    name: "Lead Dog Brewing"
  },
  {
    id: "5359",
    name: "Boss Dog Brewing"
  },
  {
    id: "5925",
    name: "Running Dogs Brewery"
  },
  ...
]
Parameter:
  • query
    • Case-insensitive

Search:

https://api.openbrewerydb.org/breweries/search?query=dog
JSON:
[
  {
    id: 530,
    name: "Diving Dog Brewhouse",
    brewery_type: "micro",
    street: "1802 Telegraph Ave",
    city: "Oakland",
    state: "California",
    postal_code: "94612-2110",
    country: "United States",
    longitude: "-122.2698881",
    latitude: "37.807739",
    phone: "5103061914",
    website_url: "http://www.divingdogbrew.com",
    updated_at: "2018-08-23T23:27:26.494Z"
  },
  ...
]
Parameter:
  • query
    • Case-insensitive

## Credits

Created and maintained by Chris J Mears and Wandering Leaf Studios LLC.

Inital dataset from Brewers Association.

Logo via Symbolicons

## Newsletter

Sign up to receive updates. No spam.

Fork me on GitHub