Open Brewery DB Scraper

Scrape brewery data from the Open Brewery DB — a free, open-source API containing 8,000+ breweries worldwide. No API key required.

What You Get

Each brewery record includes:

Field	Description
id	Unique brewery identifier
name	Brewery name
brewery_type	Type (micro, nano, regional, brewpub, large, planning, bar, contract, proprietor, closed)
address_1	Primary street address
address_2	Secondary address line
address_3	Tertiary address line
city	City
state_province	State or province
postal_code	Postal/ZIP code
country	Country
state	State name
street	Street address
phone	Phone number
website_url	Brewery website
latitude	GPS latitude
longitude	GPS longitude
recordType	Always brewery
scrapedAt	ISO 8601 timestamp

Modes

1. Search (mode=search)

Search breweries by name or keyword. Uses the /breweries/search endpoint.

Input:

{
  "mode": "search",
  "query": "craft",
  "maxItems": 50
}

2. Browse (mode=browse)

Browse breweries by location and/or type filters. Supports city, state, country, brewery type, and postal code filters.

Input:

{
  "mode": "browse",
  "city": "Austin",
  "state": "Texas",
  "country": "United States",
  "breweryType": "micro",
  "maxItems": 100
}

3. Fetch by IDs (mode=byIds)

Fetch specific breweries by their Open Brewery DB IDs.

Input:

{
  "mode": "byIds",
  "ids": ["madtree-brewing-co", "stone-brewing"],
  "maxItems": 50
}

Input Parameters

Parameter	Type	Description	Default
mode	select	search, browse, or byIds	search
query	string	Search keyword (mode=search)	—
city	string	Filter by city (mode=browse)	—
state	string	Filter by US state (mode=browse)	—
country	string	Filter by country (mode=browse)	—
breweryType	select	Brewery type filter	—
postalCode	string	Filter by postal code (mode=browse)	—
ids	array	Brewery IDs to fetch (mode=byIds)	—
maxItems	integer	Maximum results to return	50
page	integer	Starting page (1-based)	1

Brewery Types

• micro — Small, independent brewery producing under 15,000 barrels/year
• nano — Extremely small brewery, often home-based
• regional — Regional location of a larger brewery
• brewpub — A pub that brews its own beer on-site
• large — Large, industrial brewery producing 6M+ barrels/year
• planning — Brewery in planning/pre-opening stage
• bar — A bar that serves craft beer but doesn't brew
• contract — Brewery brewing under contract for another brand
• proprietor — Proprietor/alternating proprietor brewery
• closed — Permanently or temporarily closed brewery

Example Use Cases

• Craft beer app data — Build a directory of local breweries with location and contact info
• Market research — Analyze brewery distribution by type, region, or country
• Travel planning — Find breweries in a specific city or area to visit
• Competitor analysis — Research breweries of a specific type in a given market
• Data journalism — Map brewery growth and distribution across states/countries

FAQ

Is an API key required? No. Open Brewery DB is a free, open public API with no authentication required.

How many breweries are in the database? Over 8,000 breweries across the United States and internationally.

Can I get international breweries? Yes. Use mode=browse with the country filter set to any country name (e.g., "Germany", "United Kingdom", "Canada").

What does maxItems control? It caps the total number of brewery records returned. The actor fetches in pages of 50 and stops when the limit is reached.

How fresh is the data? Open Brewery DB is community-maintained and updated regularly. The scrapedAt field shows when each record was scraped.

Are all fields always populated? No. Fields like address_2, address_3, latitude, longitude, and phone may be absent if not known. Empty fields are omitted from output records.