Documentation

Bulk data

Need the whole dataset? Download it directly instead of enumerating API requests or scraping pages. Bulk crawling consumes the limited free hosting that keeps this service online.

The API below is for targeted lookups. For bulk collection, use the files above.


Single Brewery

Get a single brewery.

https://api.openbrewerydb.org/v1/breweries/{obdb-id}

Query Parameters

ParameterTypeRequiredDescription
obdb-idstringyesUnique identifier for the brewery

Response Fields

FieldTypeDescription
idstringUnique identifier for the brewery
namestringBrewery name
brewery_typestringType of brewery (see by_type for possible values)
address_1string or nullPrimary street address
address_2string or nullSecondary address line
address_3string or nullThird address line
citystringCity name
state_provincestringState or province
postal_codestringPostal or ZIP code
countrystringCountry name
longitudenumber or nullLongitude coordinate
latitudenumber or nullLatitude coordinate
phonestring or nullContact phone number
website_urlstring or nullBrewery website URL
statestringState abbreviation or name (deprecated)
streetstring or nullStreet address (deprecated)

List Breweries

Returns a list of breweries.

https://api.openbrewerydb.org/v1/breweries

Query Parameters

ParameterTypeRequiredDescription
by_citystringnoFilter breweries by city.
by_countrystringnoFilter breweries by country.
by_diststringnoSort results by distance from an origin point (latitude,longitude).
by_idsstringnoComma-separated list of brewery IDs.
by_namestringnoFilter breweries by name.
by_statestringnoFilter breweries by full state name (no abbreviations).
by_postalstringnoFilter breweries by postal or ZIP code. Supports 5-digit and postal+4 formats.
by_typestringnoFilter by brewery type (see by_type section for valid values).
pageintegernoPage number for pagination. Default: 1.
per_pageintegernoNumber of breweries per page. Default: 50. Maximum: 200.
sortstringnoSort results by one or more fields using asc or desc.

by_city

Filter breweries by city.

Note: For the parameters, you can use underscores or url encoding for spaces.

by_country

Filter breweries by country.

Note: For the parameters, you can use underscores or url encoding for spaces.

by_dist

Sort the results by distance from an origin point, denoted by latitude,longitude.

by_ids

Comma-separated list of brewery IDs.

by_name

Filter breweries by name.

Note: For the parameters, you can use underscores or url encoding for spaces.

by_state

Filter breweries by state.

Note: Full state name is required; no abbreviations. For the parameters, you can use underscores or url encoding for spaces.

by_postal

Filter breweries by postal code.

May be filtered by basic (5 digit) postal code or more precisely filtered by postal+4 (9 digit) code.

Note: If filtering by postal+4 the search must include either a hyphen or an underscore.

by_type

Filter by type of brewery.

Must be one of:

  • micro - Most craft breweries. For example, Samual Adams is still considered a micro brewery.
  • nano - An extremely small brewery which typically only distributes locally.
  • regional - A regional location of an expanded brewery. Ex. Sierra Nevada’s Asheville, NC location.
  • brewpub - A beer-focused restaurant or restaurant/bar with a brewery on-premise.
  • large - A very large brewery. Likely not for visitors. Ex. Miller-Coors. (deprecatedated)
  • planning - A brewery in planning or not yet opened to the public.
  • bar - A bar. No brewery equipment on premise. (deprecatedated)
  • contract - A brewery that uses another brewery’s equipment.
  • proprietor - Similar to contract brewing but refers more to a brewery incubator.
  • closed - A location which has been closed.

page

The offset or page of breweries to return.

per_page

Number of breweries to return each call.

Note: Default per page 50. Max per page is 200.

sort

Sort the results by one or more fields.

  • asc for ascending order
  • desc for descending order

Note: by_dist does not work with the sort filter since it is a filter of its own.

Response Fields

FieldTypeDescription
idstringUnique identifier for the brewery
namestringBrewery name
brewery_typestringType of brewery (see by_type for possible values)
address_1string or nullPrimary street address
address_2string or nullSecondary address line
address_3string or nullThird address line
citystringCity name
state_provincestringState or province
postal_codestringPostal or ZIP code
countrystringCountry name
longitudenumber or nullLongitude coordinate
latitudenumber or nullLatitude coordinate
phonestring or nullContact phone number
website_urlstring or nullBrewery website URL
statestringState abbreviation or name (deprecated)
streetstring or nullStreet address (deprecated)

Random Brewery

Get a random brewery.

https://api.openbrewerydb.org/v1/breweries/random

Query Parameters

ParameterTypeRequiredDescription
sizeintegernoNumber of breweries to return. Default: 1. Maximum: 50.

Response Fields

FieldTypeDescription
idstringUnique identifier for the brewery
namestringBrewery name
brewery_typestringType of brewery (see by_type for possible values)
address_1string or nullPrimary street address
address_2string or nullSecondary address line
address_3string or nullThird address line
citystringCity name
state_provincestringState or province
postal_codestringPostal or ZIP code
countrystringCountry name
longitudenumber or nullLongitude coordinate
latitudenumber or nullLatitude coordinate
phonestring or nullContact phone number
website_urlstring or nullBrewery website URL
statestringState abbreviation or name (deprecated)
streetstring or nullStreet address (deprecated)

Note: Returns a single brewery object by default, or an array of brewery objects when size is greater than 1.


Search Breweries

Search for breweries based on a search term. The search performs partial, case-insensitive matching against brewery names.

https://api.openbrewerydb.org/v1/breweries/search?query={search}

Query Parameters

ParameterTypeRequiredDescription
querystringyesSearch term to match against brewery names. Supports partial matches.
per_pageintegernoNumber of results per page. Default: 50. Maximum: 200.
pageintegernoPage number for pagination. Default: 1.

Response Fields

FieldTypeDescription
idstringUnique identifier for the brewery
namestringBrewery name
brewery_typestringType of brewery (see by_type for possible values)
address_1string or nullPrimary street address
address_2string or nullSecondary address line
address_3string or nullThird address line
citystringCity name
state_provincestringState or province
postal_codestringPostal or ZIP code
countrystringCountry name
longitudenumber or nullLongitude coordinate
latitudenumber or nullLatitude coordinate
phonestring or nullContact phone number
website_urlstring or nullBrewery website URL
statestringState abbreviation or name (deprecated)
streetstring or nullStreet address (deprecated)

Note: Returns an empty array [] when no breweries match the search query.


Metadata

Metadata takes the same filters as List Breweries.

https://api.openbrewerydb.org/v1/breweries/meta

Query Parameters

ParameterTypeRequiredDescription
by_citystringnoFilter breweries by city.
by_countrystringnoFilter breweries by country.
by_diststringnoSort results by distance from an origin point (latitude,longitude).
by_idsstringnoComma-separated list of brewery IDs.
by_namestringnoFilter breweries by name.
by_statestringnoFilter breweries by full state name (no abbreviations).
by_postalstringnoFilter breweries by postal or ZIP code. Supports 5-digit and postal+4 formats.
by_typestringnoFilter by brewery type (see by_type section for valid values).
pageintegernoPage number for pagination. Default: 1.
per_pageintegernoNumber of breweries per page. Default: 50. Maximum: 200.

Show all breweries meta data

Show South Korean breweries meta data

Show micro breweries meta data