Beer Scraper

# Beer Scraper

Extract comprehensive brewery data from Open Brewery DB, the largest open database of breweries worldwide. This powerful scraper enables beer enthusiasts, analysts, and developers to access thousands of brewery records for market analysis, brewery discovery, and data-driven insights.

🚀 Key Features

• Advanced Search & Filtering: Search breweries by name, location, and type
• High-Volume Data Collection: Retrieve thousands of brewery records with automatic pagination
• Structured Data Output: Clean, consistent JSON output ready for analysis
• Automatic Error Handling: Built-in retries and error management
• Geographic Filtering: Filter by city, state, country, and postal code

📊 What You Can Scrape

• Brewery Details: Names, types, addresses, contact info, and websites
• Location Data: City, state, country, postal codes, and coordinates
• Brewery Types: Micro, nano, regional, brewpub, large, planning, contract, proprietor, closed

🔧 Input Configuration

Configure your scraping job with these parameters:

Parameter	Type	Description	Default
search	string	Search query for brewery names	""
by_city	string	Filter by city	""
by_country	string	Filter by country	""
by_state	string	Filter by state (full name)	""
by_postal	string	Filter by postal / ZIP code	""
by_type	select	Filter by brewery type	""
results_wanted	integer	Maximum results to collect	100
max_pages	integer	Maximum API pages to fetch	10
sort	string	Sort order (name:asc/desc)	"name:asc"

Brewery Type Options

• micro - Most craft breweries
• nano - Extremely small breweries
• regional - Regional location of expanded brewery
• brewpub - Beer-focused restaurant with brewery
• large - Very large brewery
• planning - Brewery in planning
• contract - Uses another brewery's equipment
• proprietor - Brewery incubator
• closed - Closed location

Example Inputs

{
  "search": "Sierra Nevada",
  "by_country": "United States",
  "by_type": "micro",
  "results_wanted": 50
}

📤 Output Data Structure

Brewery Example

{
  "id": "5128df48-79fc-4f0f-8b52-d06be54d0cec",
  "name": "Sierra Nevada Brewing Co",
  "brewery_type": "regional",
  "address_1": "1075 E 20th St",
  "address_2": null,
  "address_3": null,
  "city": "Chico",
  "state_province": "California",
  "postal_code": "95928-0210",
  "country": "United States",
  "longitude": "-121.876",
  "latitude": "39.724",
  "phone": "5308933520",
  "website_url": "http://www.sierranevada.com",
  "state": "California",
  "street": "1075 E 20th St",
  "url": "http://www.sierranevada.com",
  "source": "openbrewerydb.org"
}

🎯 Usage Examples

Search for Breweries by Name

{
  "search": "Stone Brewing",
  "results_wanted": 10
}

Find Micro Breweries in California

{
  "by_state": "California",
  "by_type": "micro",
  "results_wanted": 100,
  "sort": "name:asc"
}

Breweries in a Specific City

{
  "by_city": "Portland",
  "by_country": "United States",
  "by_postal": "97201",
  "results_wanted": 50
}

⚙️ Advanced Configuration

Optimizing for Large Datasets

• Set appropriate max_pages to control API usage
• Use specific filters to narrow results before pagination
• Sort by name for alphabetical ordering

Data Filtering Tips

• Use by_country for international searches
• Filter by by_type for specific brewery categories
• Combine city and state for precise location targeting

📈 Use Cases

• Brewery Discovery: Find breweries by location and type
• Market Analysis: Analyze brewery distribution and types
• Beer Tourism: Plan brewery tours with location data
• Business Intelligence: Track brewery openings and closures
• Data Analysis: Geographic and demographic brewery studies

🔍 API Integration

This actor integrates with the public Open Brewery DB REST API to provide comprehensive brewery listings and metadata. See the dedicated API Integration section above for important details.

📋 Limits & Considerations

• Data Coverage: Over 8,000 breweries worldwide
• Data Freshness: Regularly updated community-driven database
• Geographic Coverage: Primarily US-focused with international additions

🤝 Contributing

Found a bug or have a feature request? Open an issue on our GitHub repository.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Keywords: beer scraper, brewery data, Open Brewery DB, craft beer API, brewery finder, beer tourism, brewery database