## 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",
      address: "651B W Tower Ave",
      city: "Alameda",
      state: "California",
      postal_code: "94501-5047",
      phone: "4159326531",
      website_url: "http://almanacbeer.com",
      updated_at: "2018-07-24T01:32:51.491Z"
    },
    ...
  ]
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
    • 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_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",
    address: "3301 Madison Rd",
    city: "Cincinnati",
    state: "Ohio",
    postal_code: "45209-1132",
    phone: "5138368733",
    website_url: "http://www.madtreebrewing.com",
    updated_at: "2018-07-24T01:34:01.620Z"
  }

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: 4263,
      name: "Lead Dog Brewing",
      brewery_type: "micro",
      address: "415 E 4th St",
      city: "Reno",
      state: "Nevada",
      postal_code: "89512-3315",
      phone: "7753915110",
      website_url: "http://www.leaddogbrewing.com",
      updated_at: "2018-07-25T02:13:52.688Z"
    },
    ...
  ]
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.